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About This Book 



The Advanced Programmer's Guide is a four-volume series intended for programmers who are 
experienced with both 50 Series™ computer systems and at least one high-level language 
(preferably PL/I or FORTRAN). This series consists of four volumes: 

• Advanced Programmer's Guide, Volume 0: Introduction and Error Codes 
(DOC10066-3LA) (this volume) 

• Advanced Programmer's Guide, Volume I: BIND and EPFs (DOCl(X)55-lLA) 

• Advanced Programmer's Guide, Volume 11: File System (DOC10056-2LA) 

• Advanced Programmer's Guide, Volume HI: Command Environment 
(DOC10057-1LA) 

Users of this series should be familiar with the following Prime publications: 

• PRIMOS User's Guide (DOC4130-5LA) 

• Programmer's Guide to BIND and EPFs (DOC8691-1LA) and its update 
(UPD8691-11A) 

• Subroutines Reference I: Using Subroutines (DOC10080-2LA) 

• Subroutines Reference II: File System (DOC10081-1LA) and its update 
(UPD10081-12A) 

• Subroutines Reference III: Operating System (D0C1(X)82-1LA) and its update 
(UPD10082-12A) 

• Subroutines Reference IV: Libraries and I/O (D0C1(X)83-1LA) and its update 
(UPD10083-12A) 

• Subroutines Reference V: Event Synchronization (DOC10213-1LA) 

Users of this series should also be familiar with Prime sfystem architecture, as described in the 
50 Series Technical Summary (DOC6904-2LA) and in the System Architecture Reference Guide 
(DOC9473-2LA). 
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Specifics of Tliis Volume 



This volume contains reference information applicable to the subjects described in the other 
volumes: 

• An explanation of the presentation of subroutine calls and general coding guidelines 
(Chapter 1) 

• Standard error codes used by PRIMOS, along with their messages and meanings 
(Appendices A and B) 

• New feamres of recent PRIMOS revisions that may be of interest to advanced 
programmers (Appendix Q 

• A master index encompassing the entire series 



Specifics of tlie Series 



The Advanced Programmer's Guide series is designed for system-level programmers. It 
describes the lowest-level interfaces supported by PRIMOS and its utilities. Higher-level 
interfaces not described in this series include 

• Language-directed I/O 

• The applications library (APPLIB) 

• The sort packages (VSRTLI, SyncSort/PRIME, and MSORTS) 

• Data management packages (such as MPLUSLB and PRISAMLIB) 

• Other subroutine packages 

All of the above higher-level interfaces are described in other books, such as language reference 
guides and the five volimies of the Subroutines Reference series. 

This series documents low-level interfaces for use by programmers and engineers who are 
designing new products, such as language compilers, data management software, electronic mail 
subsystems, utility packages, and so on. Such products are themselves higher-level interfaces, 
typically used by other products rather than by end users, and therefore, must use some or all of 
the low-level interfaces described in this series for best results. 

Because of the technical content of the subjects presented in this series, it is expected that these 
guides will be regularly used only by project leaders, design engineers, and technical 
supervisors, rather than by all programmers on a project. Most of the information in this series 
deals with interfaces to PRIMOS that are typically used only in small portions of a structured 
program, and with overall project design issues that should be considered before coding begins. 
Once the project is designed and the PRIMOS interfaces are designed and coded, most of the 
modules of a typical project can then be written by programmers whose knowledge of these 
issues is minimal. 
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About This Book 



Prime Documentation Conventions 

The following conventions are used throughout this document. Examples illustrate the uses of 
these conventions in typical applications. 



Convention 
UPPERCASE 



UPPERCASE 
WORDS 
(not boldface) 

lowercase 



Parentheses 
( ) 



E:)qjlanation 

In calling sequence diagrams, words in 
uppercase boldface represent the sub- 
routine name or keyword to be entered 
as shown. 

Represent the data type of subroutine 
arguments. 

In calling sequence diagrams, words in 
lowercase represent the subroutine 
arguments for which the user must 
substitute a suitable variable. 

In calling sequence diagrams, paren- 
theses must be entered exactly as 
shown. 



Example 
SLIST 



HALF INT 



(key, unit) 



(key, unit, addr) 
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Calling Sequence Conventions 

The Advanced Programmer's Guide series contains diagrams of the calling sequences of system 
subroutines. These diagrams are intended to complement the discussion of the subroutines in the 
Subroutines Reference series. Similar calling sequence diagrams are also found in an appendix 
to Subroutines Reference V: Event Synchronization. 

Figure 1-1 is a sample diagram of a calling sequence. Each calling sequence diagram occupies 
one full page. The subroutine (or procedure) name is listed in the middle of the page, followed 
on the same line by dummy parameter names listed in parentheses and s^arated by ccnnmas. 
This is the basic calling sequence for the procedure. 

Above this basic calling sequence are the input arguments; below the calling sequence are the 
output argiunents. An arrow connects each argument to a dummy parameter name. The direction 
of these arrows indicates the flow of information. These arrows also visually coimect parameter 
names to information about the parameters. This information includes the argument's data type 
and a brief description of the argument. 

Some diagrams may contain other elements, such as 

• A required value or a list of permitted values for keys or other parameters. 

• An illustration of the format of an input or ou^ut argument 

• A dot and arrow indicating that a pointer to a data area must be supplied. Execution 
of the subroutine writes information into this data area. 

Data types are specified in a data type description language. This language is further described 
in this chapter. You must convert the data type used here to the appropriate data type for your 
programming language. In addition to the data type description language, this series often 
includes PL/I or FORTRAN versions of structures. 

Procedures that are functions return a function value. This return value and its data type are 
illustrated below the name of the procedure itself. 

In addition to showing the arguments and their data types, each calling sequence diagram 

• Shows the calling sequence for a single type of operation performed by the procedure 

• Illustrates the relationships between interdependent parameters in the calling sequence 
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Read a File 



File Unit . 
Number 



K$READ 



1 



Pointer to 
Data Buffer 



Number of Halfwords 
to Read (Unsigned) 



r 



(Zero), to Read 
at Current Position 



HALF HALF ^^^ HALF FULL 

INT INT I INT INT 

PRWF$$ (key, unit, addr (buffer), size, rel-posn, halfwords-read, code) 



HALF 

INT 

ARRAY 

Buffer to Which _^ | 

Data Are Transferred 



I i 1 

,,^HALF 
INT 



HALF 
INT 



Standard 

Error 

Code 



Number of 
- Halfwords 
Actually Read 



Side Effects: Contents of buffer elements halfwords-read +1 through size are 

undefined after the operation if fewer halfwords than requested were read. 



Hgure 1-1 
Sample Subroutine Calling Sequence 
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Therefore, a multipurpose subroutine such as PRWF$$ is described using several different 
calling sequence diagrams: one for reading a file, another for writing a file, and a third for 
positioning within a file. 

Some calling sequence diagrams contain dotted arrows between related arguments. These 
relationships often involve a parameter (such as a character string) whose length is specified by 
another parameter in the calling sequence. 



Data Types 

Table 1-1 lists the generic data types and their PL/[ and FORTRAN equivalents that are used 
throughout the Advanced Programmer's Guide series. (The diagrams in Subroutines Reference V 
use PLA data types.) 

Table 1-1 
Data lypes and Their PL/I and FORTRAN Equivalents 



Data Type 


PUI 


FORTRAN 


HALF INT 
FULL INT 
n SIRING 
<=n STRING 
nBIT 
FIR 
STRUC 


HXED BIN(15) 

HXED BIN(31) 

CHARACrER(n) 

CHARACrHR(n) VARYING 

BIT(n) 

POINTER and ADDR( ) 

1 


INTEGER*2 

INTEGERS 

INTEGER*2 ((n+l)/2) 

INTEGER*2 ((n+3)/2) 

INTEGER*2 ((n+15)/16) w/maskmg 

INrEGER*2 (3) and LOC( ) 
1 


ARRAY(n) 


1 


2 



^Structures are usually illustrated in the same calling sequence diagram or in another related 
diagram, or their declarations are provided on a page near the diagram. Structures are also 
known as record data types in other languages. 

'Arrays are either a constant length which is indicated in parentheses, or a varying length 
controlled by a parameter or a subfield in a parameter. Varying length arrays have dotted 
arrows from the word ARRAY to the parameter (or its subfield) ttiat controls the length of 
the array. 

The last three data types in Table 1-1 are discussed more fully in the subsection entitled 
Pointers, Arrays, and Structures, later in this chapter. 

In cases where the length of an item is specified in the data type, such as <=128 STRING, and a 
dotted arrow is also drawn to a parameter that defines the operative length, then the length in the 
data type is the maximum lengtih for that item. 

If you are unsure as to the meaning of a keyword, arrow, or other illustrative mark, consult the 
Subroutines Reference series for more infonnation on the subroutine or data structure. 
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Keys 

Some subroutines take an input key argument. A key is a literal value that you use to specify the 
operation to be perfonned by the routine. In most calling sequence diagrams (hat involve a key 
argument, a list of valid (or appropriate) key values is provided. Each keyword corresponds to a 
specific operation. For example, the k$read key specifies a read operation. 

When the construction of a key is complex, two or more lists of keywords are often shown, 
enclosed in braces { }, with + signs to indicate addition. As with command formats, choose one 
keyword from each list in braces. Specify the + signs in your program to indicate the addition of 
these multiple keywords. For example, your program mi^t specify a key value of 
k$rdwr+k$ndam+k$getu. 

To define keywords that have names beginning with K$, use a %INa.UDE or $INSERT 
statement to insert the appropriate SYSCOM>KEYS.INS./angMage file into your program. See 
the Subroutines Reference series for more information on this topic. 



Standard Error Code 

Many subroutines include a standard error code as a parameter. This is a HALF INT value 
returned by the subroutine to indicate the degree of success encountered by the subroutine. Each 
error code can be represented by an integer value or a mnemonic. All standard error code 
mnemonics begin with E$. Always use these mnemonic values in your programs. 

For example, after each subroutine call your program should always check the standard error 
code to ensure that its value is E$OK (integer value 0). A value of E$OK means a successful 
call. Other values indicate specific errors or conditions worth noting. 

Appendix A contains a list of PRIMOS standard error codes along with a description of the 
meaning of each code. This list is ordered numerically by error code number. Appendix B 
contains an alphabetical list of the error message displayed for each enror code. The alphabetical 
list is cross-referenced with the numeric list. 

To define standard error code mnemonics for your program, use a %INCLUDE or $INSERT 
statement to insert the aR)ropriate SYSCOM>ERRD.lNS.language file into your program. See 
the Subroutines Reference series for more information on this topic. 



Side Effects 

Where appropriate, the side effects of a subroutine are listed at the bottom of tJie calling 
sequence diagram. Side effects are those actions taken by the procedure that are not obviously a 
designed function of the procedure. For example, a side effect of a call to the TSRC$$ 
subroutine may change the cache attach point without notifying its caller. 
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General Coding Guidelines 

When writing programs that use standard PRIMOS subroutines, observe the following guidelines 
to ensure that your programs continue to function normally on subsequent revisions of 
PRIMOS: 

• Your program must ignore any reserved or undefined information returned to it by a 
subroutine. For example, if a 16-bit halfword contains one defined bit and fifteen 
reserved bits, your program must mask off the fifteen reserved bits before analyzing 
the halfword to determine the value of the one defined bit. 

• Your program must zero-fill any reserved or imdefined arguments that it passes to a 
subroutine, except where otherwise specified. 

• The maximum nimiber of defined character values in a returned character string is the 
operative length of the string; characters beyond that point have undefined values and 
must be ignored. For example, a character string with a data type of 32 STRING that 
has been returned to the caller along with an operative length of 13 (as indicated by 
the dotted arrow in Figure 1-1) has undefined values for characters 14-32 in the 
returned string. 

• Arrays, structures, and similar items with operative lengths are considered undefined 
beyond those operative lengths. 

Pointers, Arrays, and Structures 

A number of PRIMOS subroutines deal with arrays and structures. The PRWF$$ subroutine, for 
©cample, uses an array as a buffer. Some of the ACL subroutines use structures to manipulate 
access control lists. A subroutine that deals with an array or a structure requires a pointer to the 
array or structure as part of its calling sequence. 

Pointers, arrays, and structures are represented as a PIVI language construct in the following 
forniat: 

addr(target-object) 

Variable Meaning 

addr The literal string addr with the data type PTR (pointer) 

target-object The name of the array or structure, enclosed in parentheses, as defined 

in the program by a data declaration statement 

Figure 1-1 shows a calling sequence containing a pointer to a buffer having the data type HALF 
INT ARRAY. 

In some cases, the array or structure serves as both an input and an ouQ)ut argument, although it 
is not necessarily used to the same ©ctent in both. For example, a structure specified as an input 
argument might contain only a required version number that you set to a q)ecific value, whereas 
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Error Code Presentation 

This appendix contains an annotated list of the standard PRIMOS error codes. The error codes 
are hsted in numerical order. Appendix B contains a cross-reference listing of these error codes, 
listed alphabetically by the text of the error message. 

Each error code consists of a number, a mnemonic, and an error message. User programs should 
always check the mnemonic value of an error code, not the numeric value or error message. You 
can use the ER$PRINT subroutine to display an error message on your terminal or use the 
ER$TEXT subroutine to return an error message to a variable in your program. These 
subroutines are further described in Subroutines Reference III: Operating System. 

The description of each error code is in the following format: 



E$xxxx {nnn) 
description of error 

Variable 

E$xxxx 

nnn 

text of error 
message 

description of error 



text of error message 



Meaning 

The mnemonic for the error code 

The numeric value of the mnemonic 

The error message displayed by ER$PRINT or ER$TEXT for that 
error code 



The description of the error code 
Mnemonics for error codes are defined by files in SYSCOM for several languages: 

Filename in SYSCOM 

errd.ins.cc 
errd.ins.ftn 
errd.ins.ftn 
errd.ins.pascal 
errd.ins.pl 1 



Language 
C 

FORTRAN 77 
FORTRAN IV 
Pascal 
PL/I 
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PMA 


ERRD.INS.PMA 


BASICA'M 


not avaUable 


COBOL 


not available 



Use the appropriate %INCLUDE (Pascal and PL/I). #include (C), or $INSERT (F77. FTN, and 
PMA) in your program to provide definitions of all the standard error codes for your program. 

Subroutines Reference I: Using Subroutines contains more infomiation on these files. 

Notes 

Severity code nxmibers, sometimes returned by CPL programs, have 
no correspondence in meaning with standard PRIMOS error codes 
with the same numeric values. Severity codes are chosen arbitrarily 
by the CPL programmer. 

When nmning user programs that involve a subsystem such as DPTX, 
you may encounter messages that are not listed in this appendix. 
These messages are related to their respective subsystems, not to 
PRIMOS. Refer to the appropriate subsystem documentation for 
further information on these error codes. 



PRIMOS Standard Error Codes 

E$OK (0) Operation completed successfully. 

The operation completed successfully. No error was detected. 

E$EOF (1) End of file. 

The end-of-file point was reached during an operation on a file system object. 
End-of-file errors may occur, for example, when 

• Reading directory entries via DIR$SE, DIR$RD, DIR$LS, or RDEN$$ 

• Positioning a file system object via PRWF$$ or SGDR$$ 

• Reading data from a file via PRWF$$ or RDLIN$ 

• Attempting to open for reading a nonexistent member of a segment directory while 
positioned at the end of that segment directory 

The interpretation of this error depends upon the operation performed. For example, when 
returned by PRWF$$ while trying to read data from a file, it indicates that end-of-file was 
reached but that some data may have been successfully read. Ifowever, when returned by 
DIR$RD, E$EOF indicates that the end of the directory was reached and no entry was 
rctumed to the calling program. 
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E$BOF (2) Beginning of file. 

An attempt was made to position a file system object to a point before the beginning of the 
file. This error results if PRWF$$ is called with a relative-position key and a negative relative 
position that wotild, when aR)lied to the current position, produce an absolute position whose 
value is less than zero. 

E$UNOP (3) Unit not open. 

The file-unit is closed or is not open for the type of operation being requested. For example, 
an attempt to read from a file that is open only for writing causes this error, as does an 
attempt to write to a file that is open only for reading. 

This error code is also returned if an attempt is made to truncate a file that is not open for 
writing. 

E$UIUS (4) Unit in use. 

The unit number supplied to a subroutine that is attempting to open a file system object is 
already in use. This error occurs only when static file-unit allocation is used (that is, when the 
k$getu subkey is not used). 

E$FIUS (5) File in use. 

The file system object being accessed is already open on another file-unit or by another user. 
This error occurs if an attempt is made to 

• Open an object that is already open by another user or by the same user on another 
file-unit, and the read/write lock of the object disallows the attempt 

• Rename an objea that is open by another user or by the same user on another file- 
unit 

• Rename a file directory that is in use as an attach point by any user 

• Set a quota on a nonquota directory that is in use or contains other files or directories 
that are in use 

• Change the open mode of a file-unit, by calling CH$MOD or SRCH$$ (with the 
kScacc key), when the object is open by another user or by the same user on another 
file-unit and the new open mode conflicts with the other open mode 

• Truncate a file or segment directory that is open by another user or by the same user 
on another file-unit 

• Access a file that is open for VMFA read 

E$BPAR (6) Bad parameter. 

An invalid value or combination of values was suR)lied to a subroutine. Many system 
subroutines are capable of returning this error code. If this error occurs, check the parameter 
values used in your subroutine call against the description in the Subroutines Reference series. 
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E$NATT (7) No directory attached. 

Usually occurs when the directory to which the user is attached is removed from the system, 
as when a disk is shut down, or in the case of a network failure when attached to a directory 
on a remote disk. Use one of the AT$ subroutines, or the ATTACH or ORIGIN command, to 
reestablish an attach point 

E$FDFL (8) Directory entry list is full. 

An attempt was made to add an entry to a directory that does not have room for the entry. 
Such entries include entries for newly created file system objects, new entries for name 
changes of existing objects, ACL information placed on a file system object, and so on. 
FIX_DISK may compress such a directory sufficiently to allow new entries to be added (if 
the -UFD_COMPRESSION and -FIX options are used), but, because a directory must reside 
in a single segment, there is a limit of approximately 4000 entries per directory even in a 
fully compressed directory. (This limit varies according to the lengths of objecinames, ACL 
information present, and the current state of directory fragmentatioa) 

E$DKFL (9) Disk is full. 

The operation requires an additional record to be allocated on a disk partition, but all records 
on that partition are already allocated. Use the AVAIL command to display the number of 
total and available records on a disk partition. 

Some operations are nonrecoverable after returning this error code. For example, the WTLIN$ 
subroutine does not restore the file location pointer to the original location when it encounters 
this error; the file location is undefined. On the other hand, the PRWF$$ subroutine does 
reset the file location pointer to the value it held before the disk full error was encountered. 

E$NRIT (10) Insufficient access rights. 

The operation could not be performed because the user running the program has insufficient 
access to perform the operation. In most cases, access is determined by either the ACL placed 
on a file system object or the password protection. In some cases, only the System 

. Administrator or the supervisor terminal user (User 1) may perform the operation. In a few 
cases, such as calling the LOGO$$ subroutine, access is determined by matching user names. 
Other cases exist, as indicated in the description of the subroutine that returned this error 
code. 

E$FDEL (11) File Open on delete . 

An attempt to delete a file, segment directory, or file directory failed because the object was 
either in use by another user, in use by the same user on another file-unit, or an EPF open for 
VMFA read. 

E$NTUD (12) Not a directory. 

The attempted operation requires the target file system object to be a file directory, but it is 
not a file directory. 
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E$NTSD (13) Not a segment directory . 

The attempted operation requires the target file system object to be a segment directory, but it 
is not a segment directory. 

E$DIRE (14) Operation illegal on directory. 

The object being referenced is a file directory or a segment directory. The requested 
operation, or the subroutine called to perform it, cannot act on a directory. 

E$FNTF (15) Not found. 

The target of the operation does not exist. Typically, the target is a file system object, but it 
can be any entity whose existence or nonexistence can be determined. 

E$FNTS (16) Not found in segment directory. 

The desired entry number was not found in the segment directory opened on the specified 
file-unit. Either no entry was found at the current position, or the specified entry could not be 
found by searching the segment directory. 

E$BNAM (17) Illegal name. 

The name supplied as a parameter for the operation does not meet the syntactic requirements 
for the corresponding object E$BNAM is also returned by the LOGO$$ subroutine. 

E$EXST (18) Already exists. 

The object to be created already exists. 

E$DNTE (19) Directory is not empty. 

An operation, such as the deletion of a directory, carmot be performed because the directory 
is not empty. 

E$SHUT (20) 
Not currently returned by PRIMOS. 

E$DISK (21) Disk I/O error. 

The FORCEW subroutine returns this error code if a disk error occurred during the forced 
writing of locate buffers. Other file system and low-level disk subroutines may return this 
error code if a disk error occurs. 

E$BDAM (22) BadDAMfile. 

EPF$MAP or EPF$RUN return this error code if the EPF DAM file structure has been 
corrupted. 
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E$PTRM (23) Pointer mismatch found. 

Many PRIMOS subroutines (for ©cample, RDLIN$ and WTLIN$) return this error code if a 
pointer mismatch is detected. This is usually caused by a corrupted disk. Run FIX_DISK to 
repair the disk. 

E$BPAS (24) Bad password. 

The password specified does not match the actual password. 

E$BCOD (25) 
Not currently returned by PRIMOS. 

E$BTRN (26) Bad truncate of segment directory. 

SGDR$$ returns this error code if an attempt was made to truncate a segment directory that 
has members beyond the desired truncation point. Such members must be removed before the 
truncation operation can succeed. 

E$OLDP (27) Old partition. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$BKEY (28) Bad key. 

Many PRIMOS subroutines use this error code to indicate that a key argument supplied by the 
caller is not a valid value. Check the description of the subroutine being called for valid 
values for the key argument 

E$BUNT (29) Bad unit number . 

Either an invalid file-unit number was supplied to a system subroutine or an invalid device 
unit number was supplied. 

Invalid File-unit Number: The file-unit number supplied is invalid (out of range). Note 
that file-units 1-128 are valid file-tmit numbers (unless the System Administrator has reduced 
the number of valid file-units by using the FILUNT directive in the system configuration 
file). Larger file-units may become valid as a user uses more dynamically allocated units. 
Invalid Device Unit Number: The device unit number is invalid. The range of valid unit 
numbers depends upon the type of device involved. (See the ASSIGN command in the 
PRIMOS Commands Reference Guide) 

E$BSUN (30) Bad segment directory unit. 

The file-unit you specified was not a segment directory unit. This error code is not returned 
by currently used subroutines; it may be returned by old programs that use obsolete 
subroutine calls. 
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E$SUNO (31) Segment directory unit not open . 

An operation was attempted on a segment directory entry when the specified segment 
directory file-xinit was not open, or was not open for the type of operation requested. The 
SRCH$$, SGDR$$, SGD$OP, SGD$EX, and SGD$DL subroutines may return this error 
code. 

E$NMLG (32) Name is too long. 

A file system objectname is too long. For example, this error code is returned if a call to 
APSFX$ to append a suffix to the specified filename would result in a filename or a 
pathname longer than PRIMOS allows. 

E$SDER (33) Segment directory error . 

SGDR$$ or SGD$OP return this error code when the segment directory member being 
opened is not a SAM or DAM file or a SAM or DAM segment directory. Contact your 
System Administrator or system operations staff to determine whether ttie situation can be 
corrected by file system maintenance. 

E$BUFD (34) Directory is damaged. 

Integrity checking performed by many file system subroutines has detected an integrity error 
in the structure of a file directory. Contact your System Administrator or system operations 
staff to determine whether the situation can be corrected by file system maintenance. 

E$BFTS (35) Buffer is too small. 

Either a caller-supplied buffer is too small to hold the data to be returned, or a buffer internal 
to the subroutine is too small to hold the data. In some cases, the error indicates that the 
requested operation could not be performed. In other cases, the operation may have been 
performed, but the data to be returned was truncated to fit into the caller-su^jlied buffer. 
Check the description of the subroutine you are calling to determine the appropriate error 
recovery. 

E$FITB (36) File is too big. 

SGDR$$ returns Ms error code if the segment directory on which it is operating is discovered 
to be longer than 131,072 halfwords (654>36 entries). 

E$NULL (37) (no message) 

This error code does not have any specific meaning attached to it. If specified in a call to 
ER$PRINT or ER$TEXT, this error code returns a null string. Many programs use E$NULL 
in calls to the obsolete subroutine ERRPR$, or to the ER$PRINT and ER$TEXT subroutines 
when the only error message desired is a user-specified error message. 
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E$IREM (38) Illegal remote reference. 

An operation was attempted that requires a reference to a remote node on the network. No 
PRIMOS support exists for such a reference. For ocample, this error code is returned when an 
attempt is made to spawn a phantom either while attached to a remote directory or while 
using a remote command file or CPL program. 

E$DVIU (39) Device in use. 

An attempt was made to assign a peripheral device, such as a magnetic tape drive, that was 
already assigned to another user. 

E$RLDN (40) Remote line is down. 

The system being referenced cannot be reached from the local system. No disks or other 
resources on that remote system can be accessed. 

E$FUIU (41) File units all in use. 

The operation could not proceed because the system lacks either available file-units or 
available named semaphores. 

No AvailaUe File-units: No more file-units are availalde for the calling process. This 
usually indicates that the program is not closing units it has finished using, since the number 
of available file-imits is usually very large. 

This error may also indicate that a remote system being used by the calling process has run 
out of file-units on which to handle this process's remote requests. 

No Available Named Semaphores: No more semaphores are available on the system for 
access via the named-semaphore subroutines. Use the STATUS SEMAPHORES command to 
display information on both numbered and named semaphores. Typically, the SEM$OP 
subroutine returns this error code if it refers to the lack of availability of named semaphores. 

E$DNS (42) Device not started. 

PRIMOS returns this error code if a low-level operation is requested on a device that is not started. 

E$TMUL (43) Too many subdirectory levels . 

The Q$READ and Q$SET subroutines and programs that perform treewalks of subdirectories 
return this error code if the number of nested subdirectories exceeds the implementation- 
defined maximum. 

E$FBST (44) 

Not currentiy returned by PRIMOS. 

E$BSGN (45) Bad segment number. 

An invalid (out-of-range) segment number was specified. For example, an attempt was made 
to set access on a segment (not a segment directory) with an invalid number via SEGAC$. 
This error code is also remmed by the MM$MLPA and MM$MLPU subroutines. 
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E$FIFC (46) FAM - invalid function code. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$TMRU (47) 

Not currently returned by PRIMOS. 

E$NASS (48) Device not assigned. 

An attempt was made to perform an operation on a peripheral device (such as a magnetic tape 
unit) that is not assigned to the user. 

E$BFSV (49) 

Not currently returned by PRIMOS. 

E$SEMO (50) Semaphore overflow. 

SEM$NF returns this error code if the number of outstanding notifies on the semaphore is 
already 32,766. 

E$NTIM (51) No timer. 

SEM$TN returns this error code if no timers are available to place on semaphores. Because of 
the potential lack of timers for numbered semaphores, you may wish to have your program 
use named semaphores and use the SEM$TW subroutine to wait for a specified amount of 
time. 

E$FABT (52) 

Not currently returned by PRIMOS. 

E$FONC (53) 

Not currendy returned by PRIMOS. 

E$NPHA (54) No phantoms available. 

An attempt to spawn a phantom (by calling PHNTM$ or PHANT$) failed because all 
phantoms are already in use. 

E$R0(»1 (55) No room. 

More entries have been returned to a fixed-length table than the table has room for. Some 
subroutines return this error code after writing as many entries as possible into the table. This 
error code is also returned by storage allocation subroutines that do not signal conditions 
when they cannot find sufficient memory. 

E$WTPR (56) Disk is write-protected. 

On a write-protected disk, you cannot open an object for writing, create an object, or change 
ttie attributes of an object 
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E$ITRE (57) Illegal treename. 

The pathname that was supplied to AT$, FIL$DL, SRSFX$, TSRC$$, or that is on a 
command line does not confonn to the syntax rules for a pathname. See the PRIMOS User's 
Guide for a description of the syntax of a pathname. 

E$FAMU (58) 

Not currently returned by PRIMOS. 

E$TMUS (59) Too many users . 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$NCOM (60) Null command line. 

The PRIMOS command environment listener uses this error code internally to distinguish a 
null command line from a successfully invoked command. It is not currently returned to the 
user. 

E$NFLT (61) No fault frame. 

CNSIG$ returns this error code to indicate that it could not find a condition frame in which to 
set the continue_sw bit to 'I'b before it found the end of the stack. This error probably results 
from calling CNSIG$ outside of an on-unit. 

E$STKF (62) Bad stack format . 

PRIMOS subroutines, such as CNSIG$, use this error code to indicate that the stack seems to 
be circular. This may be due to a circular stack or a circular list of on-units. The stack is 
considered circular if approximatdy 20,(X)0 stack frames have been examined without finding 
the desired frame or the end of the stack. The list of on-units for a particular stack frame is 
considered circular if approximately 1,(XX) on-units have been examined without finding the 
desired on-unit or the end of the list 

E$STKS (63) Bad stack format signalling. 

The condition signaling mechanism generates this error code upon detection of a bad stack 
format when it calls the command environment reinitialization subroutine. The error code 
itself is not returned by any PRIMOS subroutine. 

E$NOON (64) No on-unit found. 

A spawned phantom encountered an error during startup that cannot be handled during 
startup. Or, a crawlout condition occurred while the process was in Ring 3, indicating a 
possible internal error or an error in a user program. 
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E$CRWL (65) Fatal error in crawlout . 

An attempt was made to crawl out from one ring to another ring of equal or greater privilege, 
an invalid crawlout was attempted, or a new condition was signaled during a crawlout In all 
cases, this error code is used only in the call to the subroutine that reinitializes the user's 
command environment, and is not returned by any PRIMOS subroutine to a calling program. 

E$CROV (66) Stack overflow in crawlout. 

Insufficient room exists on the Ring 3 stack to handle a crawlout from Ring or Ring 1, or 
insufficient room exists due to a warm start following a system halt caused by a Ring stack 
overflow by the user's process. This error code is used only in the call to the subroutine that 
reinitializes the user's command environment, and is not returned by any PRIMOS subroutine 
to a calling program. 

E$CRUN (67) Crawlout unwind failed. 

The stack could not be unwound during a crawlout. This error code is used only in the call to 
the subroutine that reinitializes the user's command environment, and is not returned by any 
PRIMOS subroutine to a calling program. 

E$CMND (68) Bad command format . 

The standard command processor (STD$CP or CP$) returns this error code if the command 
line is truncated because it is too long, if the command name does not conform to filename 
syntax rules, or if the command name is more than 32 characters long. 

E$RCHR (69) Reserved character. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$NEXP (70) Corruption detected during use of EXIT. 

PRIMOS has detected a stack fitime that indicates the bottom of a static-mode program's 
stack when there is no known static-mode program suspended in the user's process. Such a 
situation is rarely encountered except in an errant program; it may be detected when a 
program calls the EXIT subroutine, in which case it causes the user's command environment 
to be reinitialized. 

E$BARG (71) Bad argument in command. 

An argument, such as a key or a pathname, is invalid, either because it is unrecognized or because 
it conflicts with other arguments. An unrecognized argument can occur if a required data area is 
not allocated. E$BARG is also used to indicate an invalid argument to a PRIMOS command. 

E$CSOV (72) Concealed stack overflow. 

PRIMOS has detected that the user's process has overflowed its Ring concealed stack, 
which is an internal error. This error code is used only in the caU to the subroutine that 
reinitializes the user's command environment, and is not returned by any PRIMOS subroutine 
to a calling program. 
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E$NOSG (73) Segment does not exist. 

A reference was made to a nonexistent segment when calling a PRIMOS subroutine to 
manipulate a segment's access rights or when attempting to change the availability of the last 
page of a segment. 

E$TRCL (74) Command line truncated. 

Subroutines that read a command line or expand text using the abbreviation preprocessor 
return this error code to indicate that the command line or the expanded text was longer than 
could be held in the buffer, and was, therefore, truncated. 

E$NDMC (75) No SMLC DMC channels. 

No further DMC channels are available for synchronous communications lines. 

E$DN;5/ (76) Device not available. 

The requested peripheral device, such as a magnetic tape unit, is not available. 

E$DflTT (77) Device already attached. 

The requested peripheral device is already attached to the user's process. 

E$BDAT (78) Bad output data . 

An incorrect data count or invalid data format exists. The SR$FR_LS subroutine returns this 
error code if it encounters an invalid pointer in a linked list. The MM$MLPA and 
MM$MLPU subroutines return this error code if you specify a page that cannot be operated 
on. E$BDAT is also returned by the LN$SET subroutine. 

E$BLEN (79) Bad length . 

The specified buffer length is invalid. The AS$LST and AS$SET subroutines return E$BLEN 
if the buffer length is not large enough. 

E$BDEV (80) Bad device number. 

An invalid number for a peripheral device, such as a commimications device, was specified. 

E$QLEX (81) Queue length exceeded. 

An internal queue carmot hold another item. 

E$NBUF (82) No buffer space. 

An attempt to acquire internal buffer space failed. 

E$INWT (83) Input waiting. 

Pending input must be read before output can be sent to the peripheral device. 
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E$NINP (84) No input available . 

No input from the peripheral device is pending. 

E$DFD (85) Device forcibly detached. 

The peripheral device was forcibly detached from the user's process; therefore, the desired 
operation cannot be performed. 

E$DNC (86) DPTX not configured. 

An attempt was made to operate a peripheral device that requires DPTX to be configured on 
the system. 

E$SICM (87) Illegal 3270 command. 

An attempt to use an invalid 3270-class command code was made. 

E$SBCF (88) Bad device number copied. 

An invalid device number was copied during an output operation to a 3270-class device. 

E$VKBL (89) 

Not currently returned by PRIMOS. 

E$VIA (90) Invalid AID byte. 

An invalid or nonexistent AID byte was supplied in the buffer for a 3270-class device. 

E$VICA (91) Invalid cursor address . 

A cursor address in a cursor-addressing command is invalid or missing. 

E$VIF (92) Invalid field address. 

A field address in a field-addressing command is invalid or missing. 

E$VFR (93) Field required. 

An invalid Held address was supplied for a formatted screen. 

E$VFP (94) Field prohibited. 

A Set Buffer Address (SBA) command was performed in an unforaiatted buffer for a 3270- 
class device. 

E$VPFC (95) Protected field check. 

An attempt was made to write into a protected field on the screen. 
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E$VNFC (96) 

Not currently returned by PRIMOS. 

E$VPEF (97) Past end of field. 

An attempt was made to write past the end of a field on ttie screen. 

E$VIRC (98) 
Not currently returned by PRIMOS. 

E$IVCM (99) Magtape command invalid. 

PRIMOS returns this error code if an invalid magnetic tape operation is requested. 

E$DNCT (100) Device not connected. 

An operation was attempted on a peripheral device that was not connected to the system or to 
the user's process. 

E$BNWD (101) Bad number of words. 

An invalid number of halfwords was specified as the size of the buffer. 

E$SGIU (102) Segment in use . 

An attempt was made to copy a segment to another segment tiiat already exists. (This refers 
to memory segments, not to segment directories or their members.) 

E$NESG (103) Not enough segments. 

Insufficient system segments are available for a program to be invoked or for additional 
storage to be acquired. 

E$SDUP (104) 

Not currently returned by PRIMOS. 

E$IVWN (105) Invalid VMFA window number . 

An EPF was corrupted, because it contains invalid VMFA window numbers. Rebuild the EPF 
by using BIND. 

E$WAIN (106) Window already in address space. 

PRIMOS uses fliis error code internally when mapping an EPF to memory to indicate that the 
EPF was already mapped to memory for this process. E$WAIN is not currently returned to 
the user. 
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E$NMVS (107) No more VMFA segments. 

Insufficient VMFA segments arc available in the system to map in an EPF. Ask your System 
Administrator to increase, if possible, the number of segments available to your process. 
Meanwhile, removing inactive EPFs from memory may temporarily alleviate the problem. 

E$NMTS (108) No more temporary segments . 

Insufficient temporary segments arc available in the system to map in the impurc procedurc 
code of an EPF (or the purc procedurc code of a remote EPF or an EPF being debugged with 
DBG). Ask your System Administrator to adjust (via NSEG) the number of temporary 
segments on your system. Meanwhile, removing inactive EPFs from memory may temporarily 
alleviate the problem. 

E$NDAM (109) Not a DAM file. 

An attempt was made to open a file for VMFA-rcad (via the k$vmr key) when the file is not 
a DAM file. 

E$NOVA (110) Not open for VMFA. 

The file-unit number supplied to EPF$RUN or EPF$MAP does not identify a unit open for 
VMFA-read (via the k$vmr key). See Volume in of this series for infonnation on how to call 
EPF$RUN or EPF$MAR 

E$NECS (111) 

Not currently returned by PRIMOS. 

E$NRCV (112) Receive enabled required. 

SMSG$ is not allowing you to send a message because you arc rcjecting messages of the 
same type (immediate or deferred) that you arc sending to another user. 

E$UNRV (113) User not receiving now. 

The user to whom you arc sending a message via SMSG$ is rcjecting immediate (and 
possibly also deferred) messages. 

E$UBSY (114) User busy, please wait. 

SMSG$ was unable to send a message to a user, either because the receiver aheady had a 
deferrcd message waiting to be displayed, or because the receiver's terminal output buffer was 
full and, therefore, an immediate message could not be sent 

E$UDEF (115) User unable to receive messages. 

The user number specified in a call to SMSG$ identifies a user who is not logged in to the 
system, but who is logged in either remotely to another system on the netwoik or through the 
system from one node to another. 



Third Edition A^15 



Advanced Programmer's Guide, \folume 



E$UADR (116) Unknown addressee. 

The user number specified in a call to SMSG$ does not correspond to a logged-in user or the 
user name specified could not be found in the list of logged-in users on the system. 

E$PRTL (117) Message operation partially blocked. 

Not all of the users who were the target of a message sent by SMSG$ received the message 
(pertiaps because they are deferring or rejecting messages). 

E$NSUC (118) Operation unsuccessful. 

When returned by the inter-user message facility (the SMSG$ subroutine), this error code 
indicates that the message reached none of the potential recipients. When returned by the 
storage allocation subroutines (STR$FS, for example), this error code indicates a comipted 
memory allocation structure. Also returned by I0CS$_GET_L0G1CAL_UNIT. This error 
code is used as a generic positive severity code with a message shghtly more meaningful than 
that displayed for E$EOF and E$NULL. 

E$NROB (119) 

Not currently returned by PRIMOS. 

E$NETE (120) Network error detected. 

A problem occurred with a remote file access. Retry the operation. If this is not successful, 
close all file-units on the remote system and attach to a directory on a different system before 
retrying the remote access. 

E$SHDN (121) Disk has been shut down. 

The disk on which the file system object resides was shut down. The disk is not available for 
use until the system operator has reenabled use of the disk. 

E$UNOD (122) Unknown node name . 

A subroutine that takes a node name has found that the named node does not exist. 

E$NDAT (123) No data found. 

No data was found. For example, a caU to LON$R to read phantom logout information 
returns this error code if there is no additional record of any phantom logout. A call to 
LN$SET returns this error code if the EPF contains no library information. 

E$ENQD (124) Enqueued only . 

A cross-process signaling message has been enqueued, but the user has not yet received the 
corresponding signal. This may be due to a low or idle user priority level or the message may 
have been deferred. 
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E$PHNA (125) Protocol handler not available. 

The desired communications protocol handler is not available. 

E$IWST (126) ESINWT enabled by configuration. 

An attempt to set attributes for a device failed because input was waiting, and the 
configuration file specified inhibition of this operation when input is waiting. 

E$BKFP (127) Bad key for this protocol. 

An invalid key was supplied either in a call involving a communications device or when 
validating a system parameter. 

E$BPRH (128) Bad protocol handler specified. 

An internal error in DPTCFG occurred. 

E$ABTI (129) I/O abort in progress. 

An I/O abort was occurring during an attempt to output data or set attributes for a 
communications device. 

E$ILFF (130) Illegal DPTX file format. 

An invalid file format for the configuration file read during DPTX initialization exists. 

E$TMED (131) Too many emulate devices. 

DPTX did not initialize because there are too many devices to emulate. 

E$DANC (132) DPTX already configured. 

An attempt was made to configure DPTX after it was already configured. 

E$NENB (133) Remote node not enabled. 

A remote operation cannot be performed because the remote node is not allowing remote file 

access. 

E$NSLA (134) No NPX slaves available. 

The remote system on which the file system object resides has become overloaded with 
remote file access requests. The operation may be attempted later, with possible success. 

E$PNTF (135) Procedure not found. 

The LINKAGE_FAULT$ condition was raised in the slave process on the remote system 
while attempting to access a remote file system object. 
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E$SVAL (136) Slave validation error. 

The user's remote ID for the system on which the file system object resides is incorrect. The 
user must use the ADD_REMOTE_ID command, described in the PRIMOS Commands 
Reference Guide, to establish the correct remote ID for the system. Until then, all attempts to 
access data on that remote system will fail with this error code. 

E$IEDI (137) I/O error or device interrupt . 

An error or interrupt occurred on a peripheral device on which low-level operations are being 
performed by the user program. 

E$WMST (138) Vferm start occurred. 

A peripheral device should be reinitialized because a warm start was performed on that 
system. 

E$DNSK (139) PIO instruction did not skip. 

A Programmed I/O instruction to a peripheral device did not skip during a low-level operation 
being performed by a user program. 

E$RSNU (140) Remote system not up. 

The remote system on which the file system object resides is in the process of starting up, but 
is not yet honoring Remote File Access (RFA) requests because the operator has not yet set 
the date and time at the supervisor terminal for that system. 

E$S18E (141) 
Not currently returned by PRIMOS. 

E$NFQB (142) No free quota blocks. 

Internal storage used to keep track of quota information for directories was exhausted. 

E$MXQB (143) Maximum quota exceeded. 

The operation requires an additional record to be allocated in a directory, but the maximum 
quota on that directory or on one of its parent directories was already reached. 
Some (but not all) operations are nonrecoverable after returning this error code. For example, 
the WTLIN$ subroutine does not restore the file location pointer to the original location when 
it encotmters this error, the file location is undefined. Other operations, such as the PRWF$$ 
subroutine, reset the file location pointer to the value it held before the quota-exceeded error 
was encountered. 

E$NOQD (14 4) Not a quota disk. 

An attempt was made to perform a quota operation on a nonquota (pre-Rev. 19 format) disk. 
The DIR$CR, Q$READ, and Q$SET subroutines may all return this error code. 
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E$QEXC (145) Quota set below current usage. 

A call to Q$SET set the maximum quota to a value that is below the number of records 
cunently used in the directory. Although this is not an error, it does mean that no new records 
can be used in the directory until enough records are deleted so that the number of records 
used falls below the maximum quota. 

E$IMFD (146) Operation illegal on MFD. 

An operation was attempted that is invalid on the MFD for a disk partitioa 

E$NACL (147) Not an ACL directory. 

An attempt to set or list ACL information was made for a file system object that resides in a 
password directory. 

E$PNAC (148) Parent not an ACL directory. 

An attempt to set or list ACL information was made for a file system object whose parent 
directory is a password directory rather than an ACL directory. 

E$NTFD (149) Not a file or directory. 

The target object of a call to AC$CAT, AC$DFT, or KLM$IF is not a file, a segment 
directory, or a file directory. You cannot protect an access category with another access 
category, nor can you set an access category to default protectioa 

E$IACL (150) Operation illegal on access category. 

An attempt was made to open, close, delete, or set improper attributes on an access category. 
Use AC$LST to read an access category. Use CAT$DL to delete an access category. The only 
proper attributes to set on an access category are dateAime attributes such as date/time last 
modified. 

E$NCAT (151) Not an access category. 

The file system object is not an access category. The AC$CAT, CAT$DL, and DIR$CR 
subroutines are all capable of returning this error code. 

E$LRNA (152) Like reference not accessible. 

AC$LIK cannot access the like reference object due to insufficient access. 

E$CPMF (153) Category protects MFD. 

An attempt was made to call CAT$DL to delete an access category that protects the MFD of 
a partition. 

E$ACBG (154) ACL too big. 

An attempt was made to specify more access control information than can fit in a directory 
entry. See Volume II of this series for a description of the limits on access control lists. 
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E$ACNF (155) Access category not found. 

The access category referenced in a call to AC$CAT or DIR$CR could not be found. A 
common cause for this error is the lack of the .ACAT suffix in the call. None of the 
PRIMOS access control subroutines add this suffix to a filename. Therefore, your program 
should call APSFX$ to ensure addition of the suffix. 

E$LRNF (156) Like reference not found. 

The AC$LIK subroutine could not find the like reference. See Volume II of this series for 
details on setting access on one object to be like that of another object. A common cause for 
this error is the false assumption that supplying a simple pathname causes the like reference 
to be searched for in the target object's directory. In fact, it is searched for in the user's home 
directory. 

E$BACL (157) Bad access control list format. 

An invalid access control list was supplied to the AC$SET or AC$CHG subroutine. See 
Volume II of this series for detailed information on the syntax for access control lists. 

E$BVER (158) Bad version number. 

A version number supplied by the calling program in a structure or in the calling sequence is 
unrecognized or no longer suRX)rted. If this error occurs in an EPF file, it may be correctable 
by resubmitting the file to BIND. 

E$NINF (159) No information is accessible. 

An error occurred while you were attempting to access a file system object in a directory to 
which you have no List access. To prevent the determination of objectnames in the directory 
by inference or by the process of elimination, PRIMOS does not report the original error to 
the calling program or to the user. E$NINF is also returned by the LN$SET and DS$AVL 
subroutines. 

E$CATF (160) Access category found in directory. 

The AC$RVT subroutine cannot revert a directory (that is, change it from an ACL directory 
to a password directory), because the directory still contains access categories. 

E$ADRF (161) ACL subdirectory found in directory. 

AC$RVT returns this error code to indicate that the directory to be reverted (changed from an 
ACL directory to a password directory) still contains ACL subdirectories that must themselves 
be reverted before their parent directory can be reverted. 

E$NVAL (162) Validation error. 

CHG$PW returns this error code if the user's entry could not be found in the EDIT_PROFILE 
database (periiaps indicating that the user's entry was deleted since the user logged in). 
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E$LOGO (163) (no message) 

PRIMOS uses this error code for internal communication when calling the subroutine that 
reinitializes a user's command envirorunent to indicate that the user is logging out Neither the 
error code nor the accompanying null message is ever returned to a user program or displayed 
on a user's tenninal. 

E$NUTP (164) No unit table available for phantom. 

All unit tables are takea 

E$UTAR (165) Unit table already returned. 

An internal PRIMOS error occurred when logging out a user. 

E$UNIU (166) Unit table not in use. 

A unit table that was not being used is being returned to the system. 

E$NFUT (167) No unit table available. 

No unit tables are available. 

E$UAHU (168) User already has unit table. 

An internal PRIMOS error occurred when logging in a user. 

E$PANF (169) Priority ACL not found. 

PA$LST returns this error code to indicate that no priority ACL was placed on the disk 
partition specified. 

E$MISA (170) Command line argument missing. 

A required argument was not specified on the command line. User-written programs may use 
this error code for similar purposes. 

E$SCCM (171) System console command only . 

The desired operation can be performed only by a program running at the supervisor terminal 
(User 1). 

E$BRPA (172) 

Not currently returned by PRIMOS. 

E$DTNS (173) Date and time not set. 

DIR$CR and Q$SET subroutines return this error code to indicate that proper disk-quota 
operations cannot be performed unless the system date and time are set. 
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E$SPND (174) Remote procedure call still pending, 

A call to a remote system has not completed within a reasonable amount of time. This error 
code indicates a non-recoverable netwoik error. 

E$BCFG (175) Network configuration mismatch. 

The remote system on which the file system object resides does not agree with the netwoik 
configuration of the local system or the remote system requires a remote ID. Use the ARID 
command to estaWish a remote ID. If the problem persists, contact your Netwoik 
Administrator for assistance. 

E$BMOD (176) Bad access mode. 

The AC$ subroutines return this error code if the access mode is not ALL, NONE, or one or 
more of the letters A, D, L, O, P, R, U, W, or X. See Volume II of this series and the 
PRIMOS User's Guide for detailed information on the ^nitax rules for access control lists. 

E$BID (177) Bad user identifier. 

AC$SET, VALID$, or CHG$SA return this error code to indicate an invalid identifier or user 
name. AC$SET may also return this error code if two specifications of $REST occur in the 
access control Ust. See Volume n of this series and the PRIMOS User's Guide for detailed 
information on the syntax of an access control list 

E$ST19 (178) Operation illegal on pre-19 disk. 

An attempt was made to use file system features that are not available for files on the 
specified disk. This is usually because the disk was formatted using an earlier revision of 
PRIMOS that did not support these features. 

E$CTPR (179) Object is category-protected. 

AC$CHG returns this error code when an attempt is made to change the access of an object 
that is protected by an access category. See Volume II of this series for information on how 
your program can handle this situation. See the PRIMOS User's Guide for detailed 
information on the rules governing access control lists. 

E$DFPR (180) Object is default -protected. 

AC$CHG returns this error code when an attempt is made to change the access of an object 
that is default-protected. 

If you wish your program to force the change anyway, have it call AC$LIK with the target 
object as both the target and reference objects; that is, set a specific ACL to match the 
existing ACL. Then, call AC$CHG to change the specific ACL on the target object 

E$DLPR (181) File is delete-protected. 

FIL$DL or SRCH$$ return this error code when an attempt is made to ddete a file that was 
delete-protected by SATR$$ (via the SET_DELETE command). 
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E$BLUE (182) 

Not currently returned by PRIMOS. 

E$NDFD (183) 
Not currently returned by PRIMOS. 

E$WFT (184) Wrong file type. 

The file specified is of the wrong type. For example, this error code is returned by CF$EXT, 
CF$REM, or CF$SME if you specify a file that is not a CAM file. 

E$FDMM (185) Format /data mismatch. 

This error code is returned by the LIST$CMD subroutine if you specify an invalid wildcard 
string. 

E$FER (186) Bad format. 

This error code is returned by the ISN$L, ISN$RC, and ISN$UC subroutines if the file 
accessed is not formatted as a High Levd Name File (HLNF). 

E$BDV (187) 

Not currently returned by PRIMOS. 

E$BFOV (188) 

Not currently returned by PRIMOS. 

E$NFAS (189) Top-level directory not founder inaccessible. 

The first directory name supplied in the pathname could not be located on any of the disks 
that are active and visible to the calling system. This error can also occur if the named 
directory does actually exist on one or more disks, but the user does not have List access to 
any of them. 

E$APND (190) Asynchronous procedure still pending. 

An attempt to initiate a new asynchronous remote procedure failed because there is a previous 
asynchronous procedure call to that remote node. Terminate the previous asynchronous 
procedure call and retry the operation. 

E$BVCC (191) Bad virtual circuit clearing. 

An error was made in clearing a virtual circuit when the user was terminating file access to a 
remote node. It does not indicate an error in the user program; it most likely indicates that a 
network problem occurred prior to the tennination of the connectioa 
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E$RESF (192) Restricted access file. 

An attempt was made to access a file that is restricted to access by only a particular 
subsystem (such as ROAM). 

E$MNPX (193) Illegal multiple hops in NPX. 

A disk partition residing on a remote node is listed on that remote node as residing on yet 
another remote node, requiring a second remote access, which is not allowed. Ask your 
System Administrator to modify the system startup file ai^ropriately. 

E$SYNT (194) 

Not currently returned by PRIMOS. 

E$USTR (195) Unterminated string. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$WNS (196) 

Not currently returned by PRIMOS. 

E$IREQ (197) 

Not currently returned by PRIMOS. 

E$VNG (198) 

Not currently returned by PRIMOS. 

E$SOR (199) 

Not currently returned by PRIMOS. 

E$TMW (200) 

Not currently returned by PRIMOS. 

E$ESV (201) 

Not currently returned by PRIMOS. 

E$YABS (202) 

Not currently returned by PRIMOS. 
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E$BCLC (203) Bad compiler library call. 

The compiler generated an invalid call to one of its runtime library routines. For example, the 
first argxmient to most of the I/O routines is a key that indicates which optional arguments 
have or have not been specified. If the compUer sets the key to indicate that a particular 
argument wiU be passed, but the compiler does not pass that argument, the error E$BCXC is 
raised. Contact your System Administrator for assistance. 

E$NSB (204) BRMS-labeled tape was detected. 

A non-BRMS product has tried to read a BRMS-labeled tape. 

E$WSLV (205) Slave ID mismatch. 

One of the nodes involved in your network connection has had the network restarted since 
you last used this remote file access connection. Attach to a directory on a different system, 
then reestablish attach points and retry the RFA operation. 

E$VCGC (206) Virtual circuit was cleared. 

The virtual circuit used for RFA access to a particular node was cleared by PRIMENET. 
Qose all imits open to that node and issue the ORIGIN command to reset the condition, then 
reestablish attach points and open files on the remote node as desired. 

E$MSLV (207) Maximum slaves per user exceeded. 

The maximum number of remote file accesses to remote systems per user has been reached 
and no new RFAs to other remote systems are allowed. 

E$IDNF (208) Slave ID number not found. 

Internal RFA error. 

E$NACC (209) Not accessible. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$UDMA (210) Not enough DMA channels. 

There are too few DMA channels during a low-level operation on a peripheral device. 

E$UDMC (211) Not enough DMC channels. 

There are too few DMC channels during a low-level operation on a peripheral device. 

E$BLEF (212) 

Not currently returned by PRIMOS. 

E$BLET (213) Bad tape record length and EOT. 

PRIMOS uses this error code internally. It is not currently returned to the user. 
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E$ALSZ (214) Allocation request too small. 

A call to STR$AL to allocate memory specified too few halfwords to allocate. You must 
allocate a minimum of four halfwords. 

E$FRER (215) Free request with invalid pointer . 

A call to STR$FR or STR$FS was made with an invalid pointer. An invalid pointer is a 
pointer to an area of memory already freed, or to a location other than the beginning of an 
allocated or fieed area. 

E$HPER (216) User storage heap is corrupted. 

The heap storage for program-class storage was corrupted. Issue the ICE command to reset 
the condition 

Alternatively, if you believe the program you were running caused the problem, issue the 
DUMP_STACK command to trace the program's history; then issue the ICE command to 
reinitialize your command environment (Errant user programs can corrupt program-class and 
process-class storage.) 

E$EPFT (217) EPF type invalid. 

The EPF type is not valid for this revision of PRIMOS. The EPF$MAP subroutine is 
typically the subroutine that returns this error code, although other EPF-related subroutines 
also may return this error code. Resubmit the file to BIND. See Volume III of this series for 
more information. 

E$EPFS (218) 

Not currently returned by PRIMOS. 

E$ILTD (219) EPF LTD linkage descriptor invalid. 

An invalid LTD linkage descriptor type was found in an EPF file. The EPF file is corrupted 
or an internal error occurred in BIND. Resubmit the file to BIND. 

E$ILTE (220) EPF LTE linkage descriptor invalid. 

An invalid LTE linkage descriptor type was found in an EPF file. The EPF file is corrupted 
or an internal error occurred in BIND. Resubmit the file to BIND. 

E$ECEB (221) Coiranand environment breadth exceeded. 

An attempt was made to invoke CP$, EPF$RUN, or EPF$INVK when the maximum 
command environment breadth (as displayed by LIST_LIMITS) was aheady reached by the 
running program. Use the RD$CE_DP subroutine to determine the current command 
environment breadth and use the CE$BRD subroutine to determine the maximum command 
envirorunent breadth within your program. 
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E$EPFL (222) EPF file exceeds file size limit. 

The EPF is too large for the EPF$MAP or EPF$RUN subroutine to handle. Consider 
breaking up the program or library into separate program and library EPFs, if possible. 

E$NTA (223) EPF file not active for this user. 

REMEPF$ and internal PRIMOS subroutines use this error code to indicate that an attempt 
was made to remove from memory an EPF that was not mapped to memory for this user. 

E$SWPS (224) 
Not currently returned by PRIMOS. 

E$SWPR (225) EPF file suspended within this process . 

The EPF being removed (by EPF$DEL, EPF$RUN, or REMEPF$) is suspended (active) 
within the user's process. Removal of the EPF from memory is not allowed in this case. 

E$ADCM (226) System Administrator command only . 

A user other than the System Administrator attempted to set system defaults for command 
environment limits. 

E$UAFU (227) Unable to allocate file-unit. 

PRIMOS was unable to allocate a file-unit entry for a user because insufficient system-class 
storage was available. 

E$FIDC (228) File inconsistent data count . 

Either a corrupted disk or a problem with the flle system exists. This error is returned during 
the truncation of a SAM flle if the data count for the last record of the file implies that the 
current position of the unit in the file is beyond the end-of-file maik. Contact your System 
Administrator or system operations staff to determine whether the situation can be corrected. 

E$INDL (229) Insufficient DAM file index levels. 

A DAM file has an insufficient number of indoc record levels for its size. This error may be 
returned during the truncation of a DAM file by PRWF$$ or during the deletion of a DAM 
file. Contact your System Administrator or system operations staff to determine whether the 
situation can be corrected. 

E$PEOF (230) Past end of file. 

Either a corrupted disk or a problem with the file system exists. This error is returned during 
the truncation of a DAM file if the data count for the last record of the file implies that the 
current position of the tmit in the file is beyond the end-of-file mark. Contact your System 
Administrator or system operations staff to determine whether the situation can be corrected. 
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E$EXMF (231) Extent map full. 

The extent map of a Contiguous Access Method (CAM) file is full. The file cannot be 
extended because no additional &ctents can be added to the extent map. 

E$BKIO (232) Unit open for block mode I/O. 

The file-unit is open for block mode VO. Operations requiring locate mode cannot be 
perfonned. 

E$fiWER (233) Asynchronous write error . 

An error occurred during an asynchronous writing action. 

E$RAMC (234) ROAM access mode conflict . 

A ROAM error, not a file system error, exists. 

E$RIER (235) ROAM internal error. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$NSLV (236) Process not a slave. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$RSIN (237) 

Not currently returned by PRIMOS. 

E$ATNS (238) Attribute not supported in directory. 

The target object does not have the dateAime created (DTQ and dateAime last accessed 
(DTA) attribute fields. These attribute fields are not present because the object is not an entry 
in a hashed directoiy. Attempts to set these attribute fields return this error code. 

E$RSHD (239) Remote disk has been shut down. 

A file system operation cannot be performed because it would take place on a remote disk 
that was shut down from the supervisor terminal on the local system. No further accesses to 
the disk are permitted from the local system. Accesses to the disk from other nodes on the 
netwoik, including the system on which the disk resides, may still be permitted. 

E$NOPD (240) No paging device defined. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$NRFC (241) 

Not currently returned by PRIMOS. 



A-28 ' Third Edition 



PRIMOS Error Codes 



E$CPOV (242) Overflow of CPU seconds. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$IOOV (243) Overflow of I/O seconds. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$BHOV (244) Overflow of CPU and I/O seconds. 

PRIMOS uses this error code internally. It is not currendy returned to the user. 

E$AELE (245) Library is non-executable. 

You tried to invoke a library EPF as a program EPF. If you want an EPF to function as both 
a program and a library EPF, you must use the MAIN subcommand of BIND to tell BIND 
what to use as a starting address. 

E$LIST (246) Search list not founder invalid. 

A search rule subroutine specified the name of a search list that is not currently set for the 
user's process. This error code is also returned if you attempt to create a search list with an 
illegal search list name. Use the LIST_SEARCH_RULES command to determine which 
search lists are set for your process. Search list names are not case sensitive. 

E$RULE (247) Search rule not founder invalid. 

A search rule subroutine specified a search rule that PRIMOS cannot find in the specified 
search list. Sometimes this error code is issued because the search rule in the list and the one 
specified in your subroutine differ in case. Use the LIST_SEARCH_RULES command to list 
the rules in your search lists. 

E$NTOP (248) Search rule not an optional rule. 

You attempted to enable or disable a search rule that is not an optional search rule. You can 
use the SR$READ subroutine to detemiine if a search rule is optional. 

E$NEST (24 9) Search lists nested too deeply. 

You attempted to set a search list using a search rules file (template file) that contains -insert 
keywords that result in either of the following conditions. Either these -insert keywords 
would result in the nested insertion of template files in excess of 100 levels, or the -insert 
keywords would result in a circular reference, such as two files that attempt to include each 
other. 

E$ADMN (250) Administrator rules not modifiable. 

You attempted to delete or modify an administrator rule in a search list, or jou attempted to 
insert a search rule before an administrator rule. 
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E$EOL (251) End of search list. 

You attempted to read past the end of a search list 

E$ADRL (252) Administrator rules contain error , 

You attempted to create an illegal administrator rule. 

E$IFCB (253) Insufficient free contiguous blocks. 

Not enough contiguous disk blocks are available to extend the CAM fde. (When CAM files 
are extended, they are extended more than one record at a time.) 

E$IMEM (254) Insufficient memory for extent map. 

The user does not have enough dynamic memory to read in the CAM file's extent map. The 
extent map, which contains the physical location of the ©ctents on flie disk, is read into 
memory when it is opened. 

E$NRES (255) No resources available for request . 

A system process was not available for use or not enough memory was available to carry out 
the request 

E$ILUS (256) Illegal use of PRIMIX gate. 

The user called a gate reserved for PRIMIX. This error may be returned when the user is not 
currenUy in PRIMIX or when that user's PRIMIX state data was corrupted. 

E$NCHD (257) No child found for this process . 

A process attempted to wait for the termination of a child when the process has no children. 
The PX$WA1TP subroutine returns this error code. 

E$INT (258) PRIMIX wait terminated by interrupt . 

A process was taken off a PRIMIX wait by an intemipt This error code is returned by 
PX$WAITP and PX$PAUSR 

E$XSHD (259) PRIMIX can not be initialized when running. 

The user attempted to start PRIMIX when PRIMIX is already active. This error code is 
returned by PX$INIT, called through the START_PRIM1X command. 

E$NOPX (260) PRIMIX can not be shut down when not running. 

The user attempted to stop PRIMIX when PRIMIX is not currently active. This error code is 
returned by PX$SHDN, called through the STOP_PRIMIX command. 
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E$NOUS (261) PRIMIX process table has no users. 

The PRIMIX process table is empty when at least one entry for the caller should have been 
found. This error code indicates a serious problem with the PRIMIX process data structure. 

E$INCO (262) PRIMIX process table returned is incomplete . 

PX$DUMP (the subroutine that returns the PRIMIX process table to the caller) ran out of 
dynamic memory so that only a partial listing of the table was returned. 

E$IREQ (263) Illegal EPF registration. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisioas. 

E$INAI (264) Invalid number of initialization arguments. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$ILLN (265) Illegal link at EPF registration. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$BUID (266) BaduserlD. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$INRE (267) Invalid request . 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$NPSG (268) Not enough per-user DTARl segments. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$UINF (269) User ID not found. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$IVPT (270) Invalid block pointer. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$SNAL (271) Segment not allocated. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$NATF (272) Not able to free storage . 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$ND3S (273) No DTAR3 segments available. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 
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E$BSMT (274) Null smt_ptr or bad field within SMT. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$IALN (275) Illegal alias name . 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$BPTR (276) Bad pointer within SMT. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$IDBT (277) Illegal database . 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$BDTR (278) Bad DTAR. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$LUNR (279) Library unregistered. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$ENRG (280) EPF has not been registered. 

Returned only for PRIMIX users at Rev. 21.0 and subsequent revisions. 

E$NDRB (281) No directory block for unit. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$CQPT (282) Circular quota parent thread. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$AREA (283) Corrupted area encountered. 

A space allocation routine found an error in internal consistency. 

E$NOWN (284) Not owner of resource. 

You attempted to return space that you do not own. 

E$BLOK (285) Bad block encountered. 

A space allocation routine found an error in internal consistency. 
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E$ISMR (286) Invalid static mode resume. 

The command processor uses E$ISMR to indicate that the module INVKSM was told to 
restore a file that is not a valid static-mode program image. The CP$ subroutine returns 
E$ISMR if a program called CP$ exists to resume or restore an invalid image. E$ISMR is 
displayed as an error message when the user has attempted to restore or resume an invalid 
image from command level. 

E$BLIN (287) Bad line number . 

A line number out of the legal range is passed to the gate. 

E$BBUF (288) Bad buffer number. 

A buffer number out of the legal range is passed to the gate. 

E$BPRO (289) Bad protocol. 

A protocol index out of the legal range is passed to the gate. 

E$LNUS (290) Line in use. 

A line type is being changed on a line that is already assigned to a user. 

E$BFUS (291) Buffer in use. 

The specified buffer ntunber is already being used by another user. 

E$IRBF (292) Invalid use of remote buffer. 

A buffer number in the remote buffer range is specified for a local asynchronous line. 

E$IABF (293) Invalid use of assign line buffer. 

A buffer number in the assignable line buffer range is specified for a terminal user line. 

E$IASD (294) Invalid ASD use. 

An attempt was made to enable ASD on an assignable line or an NTS line. 

E$IASP (295) Invalid sample speed for ASD. 

The passed line speed used as the ASD samjde speed is invalid. 

E$ILOD (296) Invalid use of DISLOG. 

You tried to enable DISLOG on an assignable, remote, or NTS line. 

E$NSNI (297) NSS database not initialized. 

An attempt was made to access the Node Status database that was created. 



Thfrd Edition A-33 



Advanced Programmer's Guide, VAslume 



E$NSNC (298) Node/LAN naming conflict . 

An attempt to add a node to the Node Status database failed because of a naming conflict. 
The node name conficts with an existing LAN name, host name, or LTS name in the 
database. 

E$NSAC (299) Node/MAC address conflict . 

An attempt to add a node to ttie Node Status database failed because of a MAC address 
conflict. The node has a MAC address that conflicts with an adsting MAC address in the 
database. 

E$NTHN (300) NTS host not configured. 

NTS was started for a host that was not configured for that NTS in the NTS configuration 
file. 

E$NTNS (301) NTS not started. 

NTS was not started and an operation requiring NTS was attempted. 

E$NTST (302) NTS already started. 

NTS was started and an operation requiring that NTS not be started was attempted. 

E$NTCF (303) Not an NTS configuration file. 

NTS was started with other than an NTS configuration file (for example, a PRIMENET or an 
SNA configuration file). This error code is also returned when the NTS config subfile 
cannot be opened, the NTS config file version number is not current, or the NTS config file 
checksum is not accurate. 

E$NTLC (304) LHC not configured. 

An LHC is either not present or was not configured with an LHC directive, but that LHC was 
specified in the NTS CMif iguration file or the PRIMENET configuration file. 

E$NTIN (305) NTS database not initialized. 

An operation that requires access to the NTS database was attempted, but the NTS database is 
not initialized. 

E$NTDL (306) LHC not downline loaded. 

An attempt was made to start PRIMENET/LAN300 or NTS on an LHC that is either broken 
or was not downline loaded. 

E$PLAA (307) NTS line already associated. 

An attempt was made to associate an NTS line that was already associated. 
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E$LLAA (308) LTS line already associated. 

An attempt was made to associate an LTS line that was already associated. 

E$NASO (309) Line not associated. 

An attempt was made to unassociate an NTS line in PRIMOS or an LTS line that is not 
cunently associated. 

E$NCFG (310) Line not configured. 

An attempt was made to start NTS, but no NTS lines arc configured. 

E$NXCB (311) XCB unavailable for request. 

An operation requires a buffer to be sent to an LHC, but no control blocks arc available. 

E$DOQF (312) Device output queue full. 

An operation requires a buffer to be sent to an LHC, but the output queue is fiill. 

E$LNOC (313) Line not connected. 

A request for a connection between an LTS line and PRIMOS has been rejected. This can 
occur when another connection is pending, when a discormection is pending, or when the line 
is not connectable. 

E$RQF (314) Request queue full. 

The internal request queue to the NTS_SERVER is fiill. 

E$CREJ (315) Connection request rejected. 

An LTS line rejected a connect request from PRIMOS. This occurs when the line is already 
connected. 

E$CTMO (316) Connection request timed out . 

An LTS line did not respond to a connect request (assignment) from PRIMOS. This occurs 
when the LTS is not prcsent or is not currently operational. 

E$LHDN (317) LHC down. 

An operation that requires an LHC to not be in the "down" state was requested when the LHC 
is down. 

E$LTDN (318) LTS down. 

An operation that requires an LTS to not be in the "down" state was requested when the LTS 
is down. 
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E$NTSH (319) NTS is shut down. 

An operation was attempted during an NTS shutdown. 

E$QFUL (320) Queue is full. 

The controller queue is full. 

E$QEMP (321) Queue is empty. 

The controller queue is empty. 

E$NOQ (322) Queue not found. 

An operation was requested on a queue that does not exist This queue does not ocist because 
it was not created by IG$FIND. 

E$VAL (323) Validation error. 

This error code is returned when a process request is rejected. A request is rejected if your 
process does not have the proper access rights, if your process does not own the connection, 
or if the logical connection ID has been corrupted. 

E$COMM (324) Command illegal . 

This error code is returned if you specify a command for a routine that cannot accept 
commands. A command is a fifteen-bit standalone quantity. Some data transfer routines, such 
as IG$ENQ and IG$DEQ, accq)t either buffers or commands. Other routines, such as 
IG$ABUF and IG$RBUF, have arguments formatted to accept commands, but cannot take 
commands. Specifying a command for these routines returns E$COMM. 

E$MIR (325) Page is already wired. 

You tried to wire a page that is already wired. 

E$IWIR (326) Page is not wired. 

You tried to unwire a page that is not wired. 

E$NPDA (327) No password directories allowed. 

Password directories are disabled on the system and you tried to either create a password 
directory or revert an ACL directory to a password directory. 

E$NINT (328) Spooler subsystem not initialized. 

You tried to spool a file before the Spooler subsystem was initialized. The system operator 
must initialize the Spooler, using the PROP -COLDSTART command, before users can 
access the Spooler. 
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E$REIU (329) Registered EPF is in use. 

PRIMOS uses liiis error code internally. It is not currently returned to the user. 

E$NBA (330) No buffers available. 

No buffers are available to make a line a terminal line. 

E$LNOW (331) Line not owned by you. 

You tried to change line characteristics for a line other than your temiinal line or a line 
assigned to you. 

E$LNP (332) Line not present on system. 

AS$LIN returns this error code if you specify a line number that does not correspond to an 
asynchronous line on the system. 

E$LNA (333) Lock not allocated. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$LDES (334) Lock has been destroyed. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$LNY (335) Lock is not yours. 

PRIMOS uses this error code internally. It is not currently returned to the user. 

E$RMLN (336) Illegal operation on remote line . 

AS$LIN returns this error code if you try to get a line niunber for a remote line. AS$LIN 
returns line numbers of local NTS lines only. 

E$ITLB (337) Invalid use of terminal line buffer. 

ASSSET returns this error code if you try to set the user number for an assignable 
asynchronous line. 

E$IPS (338) Invalid parameter setting. 

AS$SET returns this error code if you specify an invalid value for one of the asynchronous 
line characteristics. 

E$DPAR (339) Duplicate parameter , 

AS$SET returns this error code if you specify duplicate values for an asynchronous line 
characteristic in the list of line characteristics. 
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E$PNS (340) Parameter not settable. 

AS$SET returns this error code if you specify a nonexistent asynchronous line characteristic, 
or a characteristic that you are not permitted to modify. 

E$BCHK (341) 

Not currently returned by PRIMOS. 

E$EXPD (342) 
Not currently returned by PRIMOS. 

E$DNTS (343) Density not selected. 

Your attempt to specify a tape density when assigning a magnetic tape drive was rejected. 
This can occur if the specified tape is not fully rewound. 

E$SNTS (344) Speed not selected. 

Your attempt to specify a tape speed when assigning a magnetic tq)e drive was rejected. This 
can occur if the specified tape is not fully rewound. 

E$BMPC (345) Magtape controller hung. 

A magnetic tape drive did not respond to an I/O request within a reasonable amount of time. 
This can occur if the power switch on the interface box between a 6250 tape drive and its 
tape controller is off, or if there is a problem with the tape drive hardware. 

E$GPON (346) Password generation on. 

CHG$PW returns this error code if you attempt to manually set a user password when 
automatic generation of all login validation passwords is enabled. Either disable automatic 
password generation or use the GEN$PW subroutine to create a ccHnputer-generated 
password. The System Administrator can use the EDIT_PROFILE command to disable 
automatic password generatioa 

E$NGPW (347) Password generation of f. 

GEN$PW returns this error code if you attempt to create a computer-generated password 
when automatic password generation is not enabled. Either en^le automatic password 
generation, or use the CHG$PW subroutine to manually change the password. The System 
Administrator can use tiie EDIT.PRCFILE command to enable automatic password 
generation. 

E$ISTA (348) Invalid state. 

PRIMOS uses this error code internally. It is not currently returned to the user. 
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E$ZERO (349) Uninitialized block on robust partition. 

An unintialized block was detected in a file on a robust partitioa This usually happens 
following a system halt that was recovered from by ninning FIX_DISK with the -FAST 
option. The operation that returned this error code also reinitialized (zeroed out) the bad 
block. Perform recovery procedures (if necessary) and rerun the program. To prevent multiple 
E$ZERO errors, you can run nX_DISK with the -FULL option. This reinitializes all bad 
blocks on the robust partitioa 
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In the course of debugging and running application programs, you will undoubtedly encounter 
errors. These are reported on your terminal in the fonn of one or more lines of text, the first of 
which is a standard PRIMOS error message. The error message may be followed by additional 
program-specific information. 

The purpose of this appendix is to make it easier, when all you have is the text of the error 
message, to find the corresponding error message description in Appendix A. The message 
descriptions in Appendix A are ordered numerically. 

In the Ust that follows, messages are listed alphabetically by the text of the displayed error 
message. Following each error message is the numeric value for each error code in the form 
nnn, and the mnemonic for each error code in the form E$xxxx. 



Error Message 



Numeric 
Value 



Mnerrumic 



(Null message) 

(Null message for logout) 

Access category found in directory. 

Access category not found. 

AQ^ subdirectory found in directory. 

AQ^ too big. 

Administrator rules contain error. 

Administrator rules not modifiable. 

Allocation request too small. 

Already exists. 

Asynchronous procedure still pending. 

Asynchronous write error. 

Attribute not supported in directory. 

Bad access control list format. 

Bad access mode. 

Bad argument in command. 

Bad block encountered. 

Bad buffer number. 

Bad command format. 

Bad compiler library call. 

Bad DAM file. 



37 


E$NULL 


163 


E$LOGO 


160 


E$CATF 


155 


E$ACNF 


161 


E$ADRF 


154 


E$ACBG 


252 


E$ADRL 


250 


E$ADMN 


214 


E$ALSZ 


18 


E$EXST 


190 


E$APND 


233 


E$AWER 


238 


E$ATNS 


157 


E$BACL 


176 


E$BMOD 


71 


E$BARG 


285 


E$BLOK 


288 


E$BBUF 


68 


E$CMND 


203 


E$Ba.C 


22 


E$BDAM 
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Error Message 



Numeric 
Value 



Mnemonic 



Bad device number. 

Bad device number copied. 

Bad DTAR. 

Bad format. 

Bad key. 

Bad key for this protocol. 

Bad length. 

Bad line number. 

Bad number of words. 

Bad output data. 

Bad parameter. 

Bad password. 

Bad pointer within SMT. 

Bad protocol. 

Bad protocol handler specified. 

Bad segment directory unit. 

Bad segment number. 

Bad stack format 

Bad stack format signalling. 

Bad tape record length and EOT. 

Bad truncate of segment directory. 

Bad xmit number. 

Bad user ID. 

Bad user identifier. 

Bad version number. 

Bad virtual circuit clearing. 

Beginning of fUe. 

BRMS-labeled tape was detected. 

Buffer in use. 

Buffer is too small. 

Category protects MFD. 

Circular quota parent thread. 

Command environment breadth exceeded. 

Command illegal. 

Command line argument missing. 

Command line truncated. 

Concealed stack overflow. 

Connection request rejected. 

Connection request timed out. 

Corrupted area encountered. 

Corruption detected during use of EXIT. 

Crawlout unwind failed. 

Date and time not set. 

Density not selected. 
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80 


E$BDEV 


88 


E$SBCF 


278 


E$BD1R 


186 


E$FER 


28 


KSBKEY 


127 


E$BKFP 


79 


E$BLEN 


287 


E$BLIN 


101 


E$B^^WD 


78 


E$BDAT 


6 


E$BPAR 


24 


E$BPAS 


276 


E$BPTR 


289 


R$BPRO 


128 


E$BPRH 


30 


E$BSUN 


45 


E$BSGN 


62 


E$STKF 


63 


E$STKS 


213 


E$BLET 


26 


E$BTRN 


29 


E$BUNT 


266 


E$BUID 


177 


E$BID 


158 


F.$BVER 


191 


E$BVCC 


2 


E$BOF 


204 


E$NSB 


291 


E$BFUS 


35 


E$BFTS 


153 


E$CPMF 


282 


E$CQFr 


221 


E$ECEB 


324 


E$COMM 


170 


E$MISA 


74 


E$"1RCL 


72 


F,$CSOV 


315 


FSCREJ 


316 


E$CTMO 


283 


E$AREA 


70 


E$NEXP 


67 


E$CRUN 


173 


E$DTNS 


343 


E$DNTS 
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Error Message 



Numeric 
Value 



Mnemonic 



Device already attached. 

Device forcibly detached. 

Device in use. 

Device not assigned. 

Device not available. 

Device not connected. 

Device not started. 

Device ou^ut queue full. 

Directory is damaged. 

Directory entry list is fiiU. 

Directory is not empty. 

Disk has been shut dowa 

Disk VO error. 

Disk is full. 

Disk is write-protected. 

DPTX already configured. 

DPTX not configured. 

Duplicate parameter. 

E$INWT enabled by configuration. 

End of file. 

End of search list. 

Enqueued only. 

EPF file exceeds file size limit 

EPF file not active for this user. 

EPF file suspended within this process. 

EPF has not been registered. 

EPF LTD linkage descriptor invalid. 

EPF LTE linkage descriptor invalid. 

EPF type invalid. 

Extent map full. 

FAM — invalid function code. 

FAM — operation not complete. 

Fatal error in crawlout. 

Fidd prohibited. 

Field required. 

File in use. 

File inconsistent data count. 

File is delete-protected. 

File is too big. 

File open on delete. 

File units all in use. 

Format/data mismatch. 

Free request with invalid pointer. 

Illegal 3270 command. 



77 


E$DATT 


85 


E$DFD 


39 


E$DVIU 


48 


E$NASS 


76 


E$DNAV 


100 


E$DNCT 


42 


E$DNS 


312 


E$DOQF 


34 


E$BUFD 


8 


E$FDFL 


19 


E$DNTE 


121 


E$SHDN 


21 


E$DISK 


9 


E$DKFL 


56 


E$WTPR 


132 


E$DANC 


86 


E$DNC 


339 


E$DPAR 


126 


E$IWST 


1 


E$EOF 


251 


E$EOL 


124 


E$ENQD 


222 


E$EPFL 


223 


E$NTA 


225 


E$SWPR 


280 


E$ENRG 


219 


E$ILTD 


220 


E$ILTE 


217 


E$EPFT 


231 


E$EXMF 


46 


E$FIFC 


53 


E$FONC 


65 


E$CRWL 


94 


E$VFP 


93 


E$VFR 


5 


E$FIUS 


228 


E$FIDC 


181 


E$DLPR 


36 


ESFTTB 


11 


E$FDEL 


41 


E$FUIU 


185 


E$FDMM 


215 


E$FRER 


87 


E$SICM 
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Error Message 



Numeric 
Value 



Mnerrumic 



Illegal alias name. 
Illegal database. 
Illegal DPTX fde format 
Illegal EPF registration. 
Illegal link at EPF registration. 
Illegal multiple hops in NPX. 
Illegal name. 

Illegal operation on remote line. 
Illegal remote reference, 
niegal treename. 
Illegal use of PRIMIX gate. 
Input waiting. 
Insufficient access rights. 
Insufficient DAM file index levels. 
Insufficient fiee contiguous blocks. 
Insufficient memory for extent map. 
Invalid AID byte. 
Invalid ASD use. 
Invalid block pointer. 
Invalid cursor address. 
Invalid fidd address. 

Invalid number of initialization arguments. 
Invalid parameter setting. 
Invalid request 

' Invalid sample speed for ASD. 
Invalid state. 

Invalid static mode resume. 
Invalid use of assign line buffer. 
Invalid use of DISLOG. 
Invalid use of remote buffer. 
Invalid use of terminal line buffer. 
Invalid VMFA window number. 
I/O abort in progress. 
VO error or device interrupt. 
LHC down. 
LHC not ccMifigured. 
LHC not downline loaded. 
Library is non-executable. 
Library unregistered. 
Like reference not accessible. 
Like reference not found. 
Line in use. 
Line not associated. 
Line not configured. 
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275 


E$IALN 


277 


FSIDBT 


130 


E$ILFF 


263 


E$IREG 


265 


E$ILLN 


193 


E$MNPX 


17 


E$BNAM 


336 


E$RMLN 


38 


F,$IREM 


57 


FSITRE 


256 


E$ILUS 


83 


E$INWT 


10 


E$NRIT 


229 


E$INDL 


253 


E$IFCB 


254 


ESIMFM 


90 


E$VL\ 


294 


E$IASD 


270 


FSIVPr 


91 


E$VICA 


92 


E$VIF 


264 


E$INAI 


338 


E$IPS 


267 


E$INRE 


295 


E$IASP 


348 


ESIS-IA 


286 


E$ISMR 


293 


E$IABF 


296 


E$ILOD 


292 


E$IRBF 


337 


E$ITLB 


105 


E$IVWN 


129 


E$ABTI 


137 


E$IEDI 


317 


E$LHDN 


304 


ESNTLC 


306 


E$NiUL 


245 


E$AELE 


279 


E$LUNR 


152 


E$LRNA 


156 


E$LRNF 


290 


F„$LNUS 


309 


E$NASO 


310 


E$NCFG 
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Error Message 



Numeric 
Value 



Mnemonic 



Line not connected. 

Line not owned by you. 

Line not present on system. 

Lock has been destroyed. 

Lock is not yours. 

Lock not allocated. 

LTS down. 

LTS line already associated. 

Magtape command invalid. 

Magtape controller hung. 

Maximum quota exceeded. 

Maximum slaves per user exceeded. 

Message operation partially blocked. 

Name is too long. 

Network configuration mismatch. 

Network error detected. 

No buffer space. 

No buffers available. 

No child found for this process. 

No data found. 

No directory attached. 

No directory block for unit. 

No DTAR3 segments available. 

No fault frame. 

No free quota blocks. 

No tmit table available. 

No information is accessible. 

No input available. 

No more temporary segments. 

No more VMFA segments. 

No NPX slaves available. 

No on-unit found. 

No paging device defined. 

No password directories allowed. 

No phantoms available. 

No resources available for request. 

No room. 

No SMLC DMC channels. 

No timer. 

No unit table available for phantom. 

Node/LAN naming conflict. 

Node/MAC address conflict. 

Not a DAM file. 

Not a directory. 



313 


E$LNOC 


331 


E$LNOW 


332 


E$LNP 


334 


E$LDES 


335 


E$LNY 


333 


E$LNA 


318 


E$LTDN 


308 


E$LLAA 


99 


E$IVCM 


345 


E$BMPC 


143 


E$MXQB 


207 


E$MSLV 


117 


E$PRTL 


32 


E$NMLG 


175 


E$BCFG 


120 


E$NETE 


82 


E$NBUF 


330 


E$NBA 


257 


E$NCHD 


123 


E$NDAT 


7 


E$NATT 


281 


E$NDRB 


273 


E$ND3S 


61 


E$NFLT 


142 


E$NFQB 


167 


E$NFUT 


159 


E$NINF 


84 


E$NINP 


108 


E$NMTS 


107 


E$NMVS 


134 


E$NSLA 


64 


E$NOON 


240 


E$NOPD 


327 


E$NPDA 


54 


E$NPHA 


255 


E$NRES 


55 


E$ROOM 


75 


E$NDMC 


51 


E$NTIM 


164 


E$NUTP 


298 


E$NSNC 


299 


E$NSAC 


109 


E$NDAM 


12 


E$NTUD 
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Error Message 



Numeric 
Value 



Mnemcnic 



Not a file or directory. 

Not a quota disk. 

Not a segment directory. 

Not able to free storage. 

Not accessible. 

Not an access category. 

Not an ACL directory. 

Not an NTS configuration file. 

Not enough DMA channels. 

Not enough DMC channels. 

Not enough per-user DTARl segments. 

Not enough segments. 

Not foimd. 

Not found in segment directory. 

Not open for VMFA. 

Not owner of resource. 

NSS database not initialized. 

NTS aheady started. 

NTS database not initialized. 

NTS host not configured. 

NTS line already associated. 

NTS not started. 

NTS is shut down. 

Null smt_ptr or bad field witiiin SMT. 

Null command line. 

Object is category-protected. 

Object is default-protected. 

Old partition. 

Operation completed successfully. 

Operation illegal on access category. 

Operation illegal on directory. 

Operation illegal on MFD. 

Operation illegal on pre- 19 disk. 

Operation unsuccessful. 

Overflow of CPU and I/O seconds. 

Overflow of CPU seconds. 

Overflow of I/O seconds. 

Page is already wired. 

Page is not wired. 

Parameter not settable. 

Parent not an ACL directory. 

Password generation off. 

Password generation on. 

Past end of field. 
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149 


ESNThD 


144 


E$NOQD 


13 


E$NTSD 


272 


E$NATF 


209 


E$NACC 


151 


E$NCAT 


147 


E$NACL 


303 


E$NTCF 


210 


E$UDMA 


211 


F,$UDMC 


268 


E$NPSG 


103 


E$NESG 


15 


ESFNTF 


16 


E$FNTS 


110 


E$NOVA 


284 


E$NOWN 


297 


E$NSNI 


302 


E$NTST 


305 


E$NT1N 


300 


E$N1HN 


307 


E$PLAA 


301 


E$NTNS 


319 


E$NTSH 


274 


F$BSMT 


60 


E$NCOM 


179 


E$CTPR 


180 


E$DFPR 


27 


E$OLDP 





E$OK 


150 


E$IACL 


14 


E$DIRE 


146 


ESlMi-D 


178 


E$ST19 


118 


E$NSUC 


244 


E$BHOV 


242 


E$CPOV 


243 


E$IOOV 


325 


E$AWIR 


326 


E$IWIR 


340 


E$PNS 


148 


E$PNAC 


347 


E$NGPW 


346 


E$GPON 


97 


E$VPEF 
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Error Message 


Numeric 
Value 


Mnemfmic 


Past end of file. 


230 


E$PEOF 


PIO instruction did not skip. 


139 


E$DNSK 


PRIMIX can not be initialized when ninning. 


259 


E$XSHD 


PRIMIX can not be shut down when not ranning. 


260 


E$NOPX 


PRIMIX process table has no users. 


261 


E$NOUS 


PRIMIX process table returned is incomplete. 


262 


E$INCO 


PRIMIX wait tenninated by interrupt. 


258 


E$INT 


Priority ACL not found. 


169 


E$PANF 


Procedure not found. 


135 


E$PNTF 


Process not a slave. 


236 


E$NSLV 


Protected field check. 


95 


E$VPFC 


Protocol handler not available. 


125 


E$PHNA 


Pointer mismatch found (FAM only). 


23 


ESPl'RM 


Queue is empty. 


321 


E$QEMP 


Queue is ftill. 


320 


E$QFUL 


Queue length exceeded. 


81 


E$QLEX 


Queue not found. 


322 


E$NOQ 


Quota set below current usage. 


145 


E$QEXC 


Receive enabled required. 


112 


E$NRCV 


Registered EPF is in use. 


329 


E$REIU 


Remote disk has been shut down. 


239 


E$RSHD 


Remote line is down. 


40 


E$RLDN 


Remote node not enabled. 


133 


E$NENB 


Remote procedure call stiU pending. 


174 


E$SPND 


Remote system has initialized. 


237 


E$RSIN 


Remote system not up. 


140 


E$RS^fU 


Request queue Ml. 


314 


E$RQF 


Reserved character. 


69 


E$RCHR 


Restricted access file. 


192 


E$RESF 


ROAM access mode conflict 


234 


E$RAMC 


ROAM internal error. 


235 


E$RTF,R 


Search list not found or invalid. 


246 


E$LIST 


Search hsts nested too deeply. 


249 


E$NEST 


Search rule not an optional rule. 


248 


E$NTOP 


Search rule not found or invalid. 


247 


E$RULE 


Segment directory error. 


33 


E$SDER 


Segment directory imit not open. 


31 


E$SUNO 


Segment does not exist. 


73 


E$NOSG 


Segment in use. 


102 


E$SGIU 


Segment not allocated. 


271 


E$SNAL 


Semaphore overflow. 


50 


E$SEMO 


Slave ID mismatch. 


205 


E$WSLV 


Slave ID number not fotmd. 


208 


E$IDNF 


Slave validation error. 


136 


E$SVAL 
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Error Message 



Numeric 
Value 



Mnemonic 



Speed not selected. 

Spooler subsystem not initialized. 

Stack overflow in crawlout. 

System administrator command only. 

System console command only. 

Too many emulate devices. 

Too many subdirectory levels. 

Too many users. 

Top-level directory not found or inaccessible. 

Unable to allocate flle-unit 

Uninitialized block on robust partition. 

Unit in use. 

Unit not open. 

Unit open for block mode I/O. 

Unit table already returned. 

Unit table not in use. 

Unknown addressee. 

Unknown node name. 

Unterminated string. 

User already has imit table. 

User busy, please wait. 

User ID not found. 

User not receiving now. 

User storage he£^ is corrupted. 

User unable to receive messages. 

Validation error. 

Validation error. 

Virtual circuit was cleared. 

'Wma start occurred. 

Window already in address space. 

Wrong file type. 

XCB unavailable for request. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 

Unused code. 
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344 


ESSNTTS 


328 


ESmNT 


66 


E$CROV 


226 


E$ADCM 


171 


E$SCCM 


131 


E$1'MED 


43 


E$TMUL 


59 


E$TMUS 


189 


E$NFAS 


227 


E$UAFU 


349 


E$/HRO 


4 


E$UIUS 


3 


E$UNOP 


232 


FSBKIO 


165 


E$UTAR 


166 


E$UNIU 


116 


E$UADR 


122 


E$UNOD 


195 


E$USTR 


168 


E$UAHU 


114 


E$UBSY 


269 


E$UINF 


113 


E$UNRV 


216 


E$HPER 


115 


ESUDEt' 


323 


E$VAL 


162 


F$NVAL 


206 


E$VCGC 


138 


ESWMST 


106 


E$WAIN 


184 


F,$WKr 


311 


F,$NXCB 


20 


F,$SHUT 


25 


E$BCOD 


44 


E$FBST 


47 


E$TMRU 


49 


E$BFSV 


52 


E$FABT 


58 


E$FAMU 


89 


E$VKBL 


96 


E$VNFC 


98 


E$VIRC 


104 


E$SDUP 


111 


E$NECS 
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Error Message 


Numeric 
Value 


Mnenumic 


Unused code. 


119 


E$NROB 


Unused code. 


141 


E$S18E 


Unused code. 


172 


E$BRPA 


Unused code. 


182 


E$BLUE 


Unused code. 


183 


ESNDbD 


Unused code. 


187 


E$BDV 


Unused code. 


188 


E$BFOV 


Unused code. 


194 


E$SYNT 


Unused code. 


196 


E$WNS 


Unused code. 


197 


E$IREQ 


Unused code. 


198 


E$VNG 


Unused code. 


199 


E$SOR 


Unused code. 


200 


E$TMW 


Unused code. 


201 


E$ESV 


Unused code. 


202 


E$VABS 


Unused code. 


212 


E$BT.F,F 


Unused code. 


218 


E$EPFS 


Unused code. 


224 


E$SWPS 


Unused code. 


241 


E$NRFC 


Unused code. 


341 


E$BCHK 


Unused code. 


342 


E$EXPD 
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This appendix lists new features significant to the system-level programmer in recent revisions 
of PRIMOS. Summaries of new functionality appear in the Software Release Document for the 
appropriate PRIMOS revisioa For details on enhanced compiler functionality, consult the 
individual language guides. For further inforaiation on new or modified subroutines, consult the 
Subroutines Reference series. 

This appendix lists enhancements made in several recent PRIMOS revisions. The most recent 
revision is listed first. 



New Features at Revision 22.0 

Subroutines 

The following subroutines have been added at Revision 22.0: 

• The SYN$ subroutines permit you to create and destroy event synchronizers, post 
notices on event synchronizers, wait for the posting of a notice on an event 
synchronizer, and retrieve a notice from an event siynchronizer. Other SYN$ 
subroutines enable you to group several event synchronizers into an event group and 
wait for a notice or retrieve a notice from that event group. Additional SYN$ 
subroutines enable you to check the status of event synchronizers and event groups. 
These subroutines are described in Subroutines Reference V: Event Synchronization. 

• The TMR$ timer subroutines permit you to create timers that post a notice on a 
specified event synchronizer after a specified interval. There are subroutines to 
establish timers for a specified elapsed period of time, a specified time of day, or a 
specified recurrent interval of time. These subroutines arc described in Subroutines 
Reference V: Event Synchronization. 

• The TMR$GTIM and TMR$GINF subroutines return current system time or 
permanent time information. These subroutines are described in Subroutines 
Reference III: Operating System. 

• The TMR$UNIVCONVERT and TMR$LOCALCONVERT subroutines convert 
Universal Time to local time and local time to Universal Time. These subroutines are 
described in Subroutines Reference III: Operating System. 
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• 



• 



The SRS$ subroutines pennit you to detennine the server name associated with a 
process, the processes that share the same server name, and the list of all server 
names on your system. These subroutines are described in Subroutines Reference V: 
Event Synchronization. 

The ISN$ subroutines permit you to catalog the server name of a process in a High 
Level Name File (HLNP). thus making that server name available to other users, and 
to look up the server name of a process by specifying the pathname of an HLNF. 
These subroutines arc described in Subroutines Reference V: Event Synchronization. 

• The IS$ subroutines permit you to use the InterServer Communications (ISC) facility 
to exchange messages between processes. The processes can be on the same system or 
on different systems connected using PRIMENET. Subroutines arc provided for 
requesting a message exchange session between two processes, specifying event 
synchronizers and other features used during the session, sending and receiving 
messages, and terminating the sessioa There are also subroutines for retrieving 
information about a session. These subroutines are described in Subroutines Reference 
V: Event Synchronization. 

• The AS$SET, AS$LST, and AS$LIN subroutines perniit you to set the characteristics 
of an asynchronous line, retrieve the characteristics of an asynchronous line, and 
retrieve Ihe line number of an asynchronous line. These subroutines are described in 
Subroutines Reference IV: Libraries and I/O. 

• The ER$PRINT and ER$TEXT subroutines permit you to display an error message 
on your terminal or return an error message to a variable. These subroutines replace 
ERRPR$ and ERTXT$, which arc now considered obsolete. They are described in 
Subroutines Reference III: Operating System. 

• CF$EXT extends or truncates a CAM file. This subroutine is described in Subroutines 
Reference II: File System. 

• CF$REM gets a CAM file's extent map. This subroutine is described in Subroutines 
Rrference II: File System. 

• CF$SME sets a CAM file's extent length value. This subroutine is described in 
Subroutines Reference II: File System. 

• LN$SET modifies a user's search rules to permit dynamic linking to an EFF library. 
This subroutine is described in Subroutines Reference II: File System. 

• GENSPW generates a login validation password. This subroutine is described in 
Subroutines Reference III: Operating System. 

• GTROB$ determines whether a specified file is on a robust partition. This subroutine 
is described in Subroutines Reference II: File System. 

• ECL$CC and ECL$CL supervise editing of inpat from a terminal or a command file. 
ECL$CC is caUable from C. ECL$CL is an interface to ECL$CC for non-C 
programs. These subroutines are described in Subroutines Reference III: Operating 
System. 

• NT$LTS returns the characteristics of a PRIMOS networic terminal service line. This 
subroutine is described in Subroutines Reference IV: Libraries and I/O. 
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ICES has been enhanced to support synchronizers, timers, ISC sessions, and other 
features of PRIMOS. This subroutine is described in Sidyroutines Reference III: 
Operating System. 



PRIMOS Commands 

Revision 22.0 has the following new PRIMOS commands: 

• The LIST_SESSIONS and LIST_SERVER_NAMES commands and the -SERVER 
option for the INITIALIZE.COMMAND.ENVIRONMENT (ICE) command support 
servers and ISC sessions. 

• The LIST_CONnGUOUS_BLOCKS and LIST_EXTENT_MAP (LEM) commands 
support CAM flies. 

• The UX_TAPE command saves files to tape in a format that the UNIX CPIO and 
TAR utilities can read. It restores files from a tape created by either CPIO or TAR. 

The EDIT_CMD_LINE (ECL) facility has been enhanced to include the user's ability to define 
terminal key functions for editing a command line. ECL is described in PRIMOS Commands 
Reference Guide and PRIMOS User's Guide. 

Subsystem Enhancements 

The following subsystems have been enhanced with additional features and options. These arc 
further described in the Software Release Document and the documentation for the individual 
subsystems. 

• The Spooler subsystem has been enhanced with additional embedded control code 
options and several new command features. The SPOOL command has four new 
options: -XLATE for character set mapping, -FROM and -TO for printing a part of 
a document, and -SPOOL_W for printing a file while it is open for writing. The new 
AUXILIARY command passes environment parameters to print handlers. The PROP 
command -BACK option has been extended. 

• MAGNET has been extended to handle the Prime Extended Character Set (Prime 
ECS) and to support large tape buffers. 

• Tape utilities (such as MAGSAV and MAGRST) at Rev. 22.0 pemit a larger 
maximum record size. This enhancement is due to a change in the T$MT subroutine. 

New Features at Revision 21 .0 

Subroutines 

The following subroutines are either added or enhanced at Revision 21.0: 
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• DS$AVL returns data about a disk partition in a structure. Data returned includes the 
version number of the structure to be returned, the name of the partition, its 
maximum capacity, the nimiber of free records, and the date and time the partition 
was last backed up. 



• 



DS$ENV returns data about the user's process. Data returned includes the filename of 
the currently active abbreviation file; the unit number of the current command input 
file; the user's current command level, erase character, and kill characters; the default 
and current user timeslice; the CPU and login time remaining; the QUIT inhibit 
count; the number and name of the AOL groups to which the user belongs; and the 
niraiber, name, node, user ID, and project ID for the user's remote IDs. 

• DS$UNI remms data about file-imits. Data remmed includes information about attach 
points, the user number, access bits if the file is open on a local system, open mode, 
the command output file-unit, and the system name if the file is open on a remote 
system. 

• GSNAM$ is used by any program to determine the name of the system the program 
is running on. 

• G$METR returns system metering information, such as that provided by the USAGE 
command. This infomiation can be for general system meters, file system meters, 
interrupt process meters, system meters for an individual user, meters for memory 
usage, meters for disk usage, and meters for ROAM usage. Returned information 
includes the CPU, I/O, and real time used, the number of I/O operations since system 
boot, the number of users configured, information about locate buffers, and read and 
write operations performed. 

• KLM$IF enables a program to obtain serialization data from a specified file. KLM$IF 
uses a simple filename, supplied by a program, and system search rules to obtain 
serialization data from an installed product of that name. Data obtained about the 
product can include its version number, its name, its revision nimiber, its serial 
number, the name of the licensed user, the software expiration date, PRIMOS 
support, the name of the organization distributing the software, the name of the 
individual responsible for software revision, the software distribution date, the order 
number of the distributed software, and the customer service number for the product 
license. 

• LOV$SW indicates if the login-over-login function is currently permitted. 

• LUDEV$ returns a list of devices that a user can access. The devices listed arc those 
that are specified by the user with the ASSIGN command. Information returned 
includes the version number, the maximum number of devices that may be accessed, 
and a list of devices that the user may access. 

• MM$MLPA makes the last page of a segment available. 

• MMSMLPU makes the last page of a segment unavailable. Subsequent attempts to 
access the page result in the OUT_OF_BOUNDS$ condition. 

• SGD$EX determines if there is a valid entry at the current position within the 
segment directory on a specified unit. 
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• SNCHK$ checks the validity of the system name passed to it. SNCHK$ enables 
subsystems that deal with system names at a command interface to check the names 
for validity without knowing the syntax rules for system names. 

• SP$REQ inserts a file into the spool queue. 

• SR$ABSDS (or SR$ABS for FTN) disables optional search rules enabled by 
SR$ENABL. SR$ABSDS absolutely disables an enabled rule, regardless of how 
many times the rule has been enabled. 

• SR$ADDB (or SR$ADB for FTN) adds a rule to the start of a search list or before a 
specified rule within the list. 

• SR$ADDE (or SR$ADE for FTN) adds a rule to the end of a search list or after a 
specified rule within the list. 

• SR$CREAT (or SR$CRE for FTN) creates a blank search list The created search list 
does not contain any user-specified or system default search rules. This search list 
does, however, contain administrator rules if the System Administrator has estaWished 
administrator rules for the search list. 

• SR$DEL deletes a specified search list. Both the user's search list and its contents 
(including administrator rules) are deleted. The search rules fde that was used to set 
the search list is unaffected. 

• SR$DSABL (or SR$DSA for FTN) disables an optional search rule enabled by 
SR$ENABL. This subroutine reverses a single SR$ENABL operation. Compare this 
with SR$ABSDS. 

• SR$ENABL (or SR$ENA for FTN) enables an optional search rule. You can disable 
enabled rules using SR$DSABL or SR$ABSDS. 

• SR$EXSTR (or SR$EXS for FTN) determines if a search rule exists in a specified 
search list. The search rule can be a pathname, an optional search rule, or a search 
rule keyword. SR$EXSTR determines the existence of both disabled and enabled 
optional search rules. 

• SR$ni„LS (or SR$FRL for FTN) ftees list structure space allocated by SR$LIST or 
SR$READ. Invoke SR$FR_LS after every successful invocation of SR$LIST or 
SR$READ. SR$FR_LS deletes a structure by following the structure's internal pointers. 

• SR$INIT (or SR$INI for FTN) initializes all search lists to system defaults. System 
default rules include all rules found in the directory SEARCH.RULES*", including 
system rules and administrator rules. If no system defaults exist for a search list, 
SRSE^mr deletes the search list 

• SR$LIST (or SRSLIS for FTN) returns the names of the user's search lists. SR$LIST 
copies information about all of the user's search lists into a user-specified structure. 
SR$LIST creates a separate structure entry for each of the user's search lists. 

• SR$NEXTR (or SR$NEX for FTN) reads the rules from a search list, sequentially 
and one at a time. Each invocation of SRSNEXTR reads one rule. To read aU of the 
rules in a search list, use SR$READ. SRSNEXTR reads locator pointer values. 
SR$NEXTR does not read disabled optional search rules. 
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• SR$READ (or SR$REA for FTN) reads all of the rules in a search list into a 
stracture established by the user. SR$READ reads all rules, including disabled rules. 
SR$READ creates a separate structure entry for each search rule. 

• SR$REM removes a search rule from a specified search list SR$REM can delete 
user-specified and system default search rules and keywords. SR$REM cannot delete 
administrator search rules. 

• SRSSETL (or SR$SET for FTN) sets or modifies the locator pointer for a search rule. 
SRSSETL can set locator pointers of search rules in user-defined search lists and 
search rales in the ENTRY$ search list. 

• SR$SSR sets a search list via a user-defmed search rules file. SR$SSR can create a 
new search list, overwrite an existing search list, or append rules to an existing search 
list. 

• K$BKUP was added to SRSFX$ to allow a file to be read by the backup facility. 



Other New Features 

Revision 21.0 has the following new features and changes: 

• Extension to the use of search lists and ability for the user to define search lists. See 
the Advanced Programmer's Guide, Volume II: File System for a complete discussion. 

• Prime ECS support (expanded character set). 

• CBL support of DSTCLUDES search rules, enhanced magnetic tape support, relative 
file enhancements for MIDASPLUS™ and PRISAM,™ and new compiler options. 

• CC support of INO^UDES search rules, the UlSflX/ANSI restriction on files opened 
with FOPEN, and a new meaning of the returned value of QPEN(). 

• F77 support of INCLUDES search niles, SHORTCALL functionality in I mode, 
longer string constants, and optimization enhancements. 

• FTN generation of V-mode code as the compiler default 

• PMA support of the MDP pseudo-op, mode determination of variables and 
©ipressions, assemWer listing, general register relative format, and IX-mode 
instmctions. 

• Pascal support of INCLUDES search rules and some changes concerning the ANSI/ 
IEEE standard. 

• VRPG support of INCLUDES search rule. 

• BIND support of COMPRESS and INITIALIZE.DATA. 

• EMACS interface with Prime Common LISP. 
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New Features at Revision 20.2 

New Features 

Revision 20.2 has the following new features and changes: 

• CBL_LIBRARY supports sequential file access and variable length tables and 
records. 

• CC_LIBRARY resolves potential library routine and runfile conflicts. 

• System Library supports F77 octal and decimal formatting and an improved random 
number generator. 

• VRSTLI becomes an Executable Program Fbrmat (EPF). 

• MATRIX_LIBRARY (MATHLB) becomes an Executable Program Fonnat (EPF). 

• VRPG supports new options. 

• PLA supports new options. 

• F77 supports new options, statements, constants, static mapping to tape unit, and 
enhanced cross-reference functionality. 

• CC supports 32IX mode, new options, new switches, a FORTRAN interface, and has 
changes in the ctype.h header file. 

• Pascal supports new options, conforms to the ANSI/EEE standards, and provides 
new options for ANSI/TEEE standards conformance. 

• The Source Level Debugger suf^rts variable length records, octal and hexadecimal 
constants, and has enhancements to MACRQ 

• BIND supports two new subcommands. 

• EMACS provides UNIX pathname support, two new PEEL fimctions, and a new 
PEEL atom. 

• K$DTA and K$DTC keys added to SATR$$ to allow setting of date/time accessed 
and dateAime created. 

• The subroutine SRSFX$, which supports pathnames, can now be used to search for a 
file. T$SRC, which was previously used, is obsolete at this revision. 

System Library 

The System Library supports the following changes at Rev. 20.2: 

• F77 octal and hexadecimal fonnatting 

• Random number generation 
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New Features at Revision 20.0 
Subroutines 

The following subroutines are either added or enhanced at Revision 20.0: 

• DIRSCR creates a new directory. This subroutine accepts pathnames and replaces 
C!REA$$ and CREPW$, which are obsolete at this revisioa 

• DIR$RD reads the contents of a directory sequentially, entry by entry. 

• DERSSE searches the directory with caller-specified selection criteria. 

• DKGEO$ counts the sectors of a disk that has been formatted in a nonstandard 
manner. 

• I0CS$_FREE_L0GICAL_UN1T frees a logical file-unit number and makes it 
available in the Logical Unit Table (LUTBL). 

• IOCS$GET_LOGICAL_UNIT provides an availaWe logical file-unit number to the 
calling program. 

• SIZES returns the size of a file system entry without updating Date Time Accessed 
(DTA). 

• UNITS reads the current minimum and maximum unit number for this user. 

Other New Features 

Revision 20.0 has the following new features and changes: 

• Directories are now organized as hashed ACL directories. 

• The new file attributes, date and time created (DTQ and date and time last accessed 
(DTA) may appear in Rev. 20.0 or later directories (hashed directories). 

• The structure returned alter calls to DIR$RD or ENT$RD includes the new file 
attributes DTC and DTA. 
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Key to Master Index: 

Abbreviation Document Title Docunent Number 

Mvanoed Programmer's Guide, Volxane 0: 

Introdxiction aoi Error Codes EOC10066-3LA 

1 Mvanoed Prograinmer ' s Guide, Voltune I: 

Bind aai EPFs D0C10O55-1LA 

II Mvanoed Programmer's Guide, Voltime 

II: File System EOC10056-2LA 

III Mvanoed Programmer's Guide, Voltime 

III: The Cammand Environment IOC10057-1LA 
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Symbols 

; (command, sepaxator dharacter), 
III: 2-3 

~ (tilde). III: 2-2, 4-11 



ABBREV canmaDd, III: 2-3 

Abbreviation processor, III: 
1-19 

Abbreviations , 

disabled at mini-command, level, 
III: 5-14 

Absolute pathname, II: 1-12, 
7-2, 7-5 

AC$CAT subroutine, II: 2-19, 
7-2, 7-5 

AC$CHG s\ibroutine, II: 2-22, 
7-2, 7-6, 7-7, 7-9 

ACSDFT subroutine, II: 2-17, 
7-2, 7-3 



AC$LIK subroutine, II: 2-20, 7-8 

AC$I£T subroutine, II: 7-2, 7-9, 
7-10 

ACSRVT subroutine, II: 4-7 

AC$SET subroutine, II: 2-18, 
2-21. 7-2. 7-4. 7-6 

Access calculation, II: 1-26 
concepts, II: 1-19 
how and when done, II: 1-19, 

1-22 
when attaching to a directory, 

II: 1-21 
when opening files, II: 1-21 

Access category, II: 1-10, 1-18, 
2-21 
creating, II: 7-2 

Access Control Lists (ACLs), II: 
1-5, 1-18, 2-13, 7-11 
( See also Access rights) 
Access pairs limit, II: 7-11 
nhanging rights, II: 2-22 
default, II: 2-7 
deleting entries, II: 2-23 
device, II: 7-1 
entries structure, II: 2-16 
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Access Control Lists (ACts) 
(continued) 
functions, II: 2-16 
limitations, II: 7-11 
manipulating, II: 7-1 
parsing, II: 7-9 
setting, II: 7-2 

Access methods, 

direct (DAM), II: 1-15 
sequential (SAM), II: 1-15 

Access rigjits, (See also Access 

Control Lists (ACLs)) 
A ajcoess, II: 2-6 
AIL access, II: 1-18, 2-6 
Changing, II: 2-22 
areating a category, II: 2-21 
D access, II: 2-6 
deleting, II: 2-23 
L access, II: 2-6 
needed to attacti to directory, 

II: 2-13 
needed to change ACLs, II: 

2-17 
needed to create object, II: 

2-24 
needed, to delete object, II: 

2-12, 2-37 
needed to open object, II: 

2-27 
needed to read object, II: 

2-30 
needed to write to object, II: 

2-34 
NONE access, II: 2-6 
O access, II: 2-6 
P access, II: 2-6 
R access, II: 2-6 
setting a category, II: 2-19 
setting specific, II: 2-18 
setting the same as another 

object, II: 2-20 
setting to default, II: 2-17 
U access, II: 2-6 
W access, II: 2-6 
X access, II: 2-6 

-AOCESS_CATBGCRY bit, III: 3-21, 
4-33 

Accessing text files, II: 5-2 



ACL-related subroutines, 
struct\ire, II: 2-16 

-added_disks, II: 3-6, 3-16 

ACDISK, command, II: 4-5 

Addresses, 

act-ual, I: 1-10, 9-2 

BCB in the BIND map, I: 9-6 

fonn of, I: 9-2 

imaginary, I: 1-10, 1-14, 9-2 

link frame in the BIND map, I: 

9-7 
LISTJEPF command, I: 9-3 
mapping of, I: 9-1 
offsets in, I: 9-2 
procedure code in the BIND map, 

I: 9-6 
segment numbers in, I: 9-2 
stack frame in DtMP_STACK 

command, I: 9-9 

Administrator search rules, II: 

3-4 
in search rules file, II: 3-10 
process initialization, II: 

3-11 

AIiC$RA subroutine. III: 3-9, 
3-10, 3-13 

Allocating, 

linkage areas, via EPFSALLC, 
III: 4-34 

AI£$RA subroutine. III: 3-9, 
3-10, 3-12 

ANY$ condition. III: 1-22, 5-15 

Applications , 

command environment support 

for. III: 1-7 
defined. III: 1-7 

Arguments to program EPFs, I: 
1-16 

ATS subroutine, II: 2-15, 4-5, 
4-7, 4-8, 4-10 

AT$ABS subroutine, II: 2-15, 
4-5, 4-7, 4-9, 4-11 



Third Edition 



Iniex-2 



Master Index 



ATSANY subroutine, II: 2-15, 
4-5, 4-7, 4-8, 4-13 

AT$IOI subroutine , II : 2-8 , 
2-14, 4-i, 4-6, 4-8 

AT$CR subroutine, II: 2-13, 4-1, 
4-2, 4-6 

AT$REL subroutine, II: 2-15, 
4-6, 4-7, 4-16, 4-17 

ATCH$$ subroutine, II: 4-6 

Attacii, 

to directory, II: 1-16, 2-13 
to lower-level directory, II: 

4-16 
to specific directory, II: 4-8 
to top-level directory, II: 

4-9, 4-13 

ATTACHS, II: 3-2, 3-6 

-added_disks keyword, II: 3-16 
default if not set, II: 3-7, 

3-21 
default value of, II: 3-6 
-sjTStem keyword, II: 3-15 
vise iy other searcli lists, II: 

3-21 

ATTACH comina-nd. II: 1-13, 1-16, 
2-8, 2-14, 2-15, 4-3, 4-5, 
4-9 

Attadi point, 

cacihe. III: 6-2 

current, II: 1-17, 2-5, 2-8, 

2-13, 4-1, 4-5, 4-6, 4-9, 

4-13 
home, II: 1-20, 2-5, 2-8, 

2-13. 4-1, 4-3, 4-13 
initial, II: 2-5, 2-13, 4-1 
manipulating, II: 4-7 
questions, II: 4-24 
search rules, II: 3-2 

Attribute ( See File attributes) 

AVAIL, command, II: 9-1 



B 

Bad sector, II: 1-7 

Bad spot file (BADSFT), II: 1-7 

.BIN file, I: 3-6, 3-7 

BINARY$, II: 3-2, 3-8 

Binary editors, I: 10-1 

Binary files, 

searching directories for, II: 
3-8 

BIND, I: 1-2, 1-6 
benefits of using, I: 1-9 
BINARY$ search list, II: 3-8 
IKNT subcommaaa, I: 5-5 
ENTRY$ search list, II: 3-9 
ENTRYNAME subcomtnand, I: 3-15 
entrypoint subcoimnand, I: 6-8 
initialization of static data, 

I: 1-19 
LIBEIARY subcaramani, I: 3-11 
linking object fil^, I: 3-7 
MAIN subcommaai, I: 3-15, 5-5 
MAP subcaramani, I: 9-5 
NO_GENERATI0N subcoramaol. III: 

2-2 
iro_ITEElATION subcoranaai. III: 

2-2 
N0_1REEWAIK subcominani, III: 

2-2 
N0_WI1DGARD subcoranaai, III: 

2-2 
RESaLVE_nEFERRED_OCMWCN 

subcammand, I: 3-15 
SYMBCL subcommand, I: 3-11, 

8-2, 8-i 
treatment of caramon area, I: 

3-11, 3-15 
treatment of IPs, I: 3-10, 

3-11 
use of segment numbers, I: 

3-10 

BIND map, I: 9-5 to 9-7 
determining BC5B addresses, I: 

9-6 
determining link frame 

addresses, I: 9-7 
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BIND map (continued) 
determining prooeduxe code 
addresses, I: 9-6 

Bootstrap file (BOCO?), II: 1-7 

-BOnCMJJP bit, III: 3-21 

Building shaxed programs v?ith 
SBG, I: 1-8 



CdCbB attach point, 

as a static resou3X>e, III: 6-2 

CALAC$ subroutine, II: 7-9 

Calling sequences, 

corainaai, detailed. III: 3-15, 

3-17 
complete. III: 3-26, 3-29 
data types in diagrajre, 0: 1-4 
diagrams explained, 0: 1-1 
error codes. III: 3-5 
for coramand functions. III: 

3-€ 
for commands. III: 3-3, 3-4 
for program EPFs, III: 3-1 
for programs. III: 3-3 
sample diagram, 0: 1-2 

Cartricage Module Devices (CMDs). 
II: 1-5 

CH$MOD subroutine, II: 5^7 

CLO$FN subroutine, II: 2-36, 
5-21, 5-23, 5-^B 

CLDSFU subroutine, II: 2-36, 
5-21, 5-22, 5-^8, 6-2, 6-1 

CUOSSA subroutine, II: 2-37 

CaDSE command, II: 2-36 



Closing a file, II: 5-21 
after EPF$RUN retiims. III: 

4-25 
on abnormal program 

termination, II: 1-30 
on normal program termination, 

II: 1-30 
system object, II: 2-36 

CNAM$$ subroutine, II: 4-7, 6-43 

Code argument, 

for CP$, III: 4-12 

for EPF$MAP subroutine. III: 

4-29 
for EPF$RUN, III: 4-22 

Coding Guidelines, 
general , : 1-5 
pointer usage, 0: 1-6 
pointers, axrajre, and 
striKJtures, 0: 1-5 

OCMI$$ subroutine, II: 4-7 

GCMINPUT files, 

command environment support 
for. III: 1-3 

Command, 
defined. III: 1-8 
invocation. III: l-lO 
name, determination of, III: 
2-4 

Coramaai calling sequence. III: 
3-3 
arguments for. III: 3-3 
error codes for. III: 3-5 

Command environment. III: l-l 
( See also command processing 

information) 
abbreviation processor, III: 

1-19 
commaixi features decoder. III: 

1-21 
command interface, III: 1-10 
command li-nft reader. III: 1-19 
coramand preprocessor. III: 

1-21 
coramand processor. III: 1-20 
command prompter. III: 1-19 
default on-unit. III: 1-22 



Third Edition 



Index-4 



Master Indeac 



Cammand enviromnent (continued) 
feattires for applications, 

III: 1-7 
featirres for OCMINPaT files, 

III: 1-3 
feat-ures for CEL programs, 

III: 1-4 
features for interactive lasers, 

III: 1-2 
featiires for \iser-written 

functions, III: 1-7 
features for user^written 

programs. III: i-6 
Isey modules, III: 1-16 
listener. III: 1-17 
program invoikers. III: 1-22 



Command features decoder, 
1-21 



III: 



Coniinaiid file, 

searching directories for, II: 
3-7 

Command function calling 
sequence, III: 3-6, 3-8 

Commaj3d function invocation, 
via CP$, III: 4-13 
via EPFSINVK, III: 4-27 
via EPF$RUN, III: 4-18 

Command functic-ns, II: 2-1, 2-2; 

III: 4^ 
actions of. III: 3-6 
arguments for calling sequence, 

III: 3-7 
behavior when invoked as 

commands, III: 4-4 
needing command name. III: 

3-27 
needing local CEL variaJales, 

III: 3-27 
santple programs. III: 3-11 
special cases of. III: 3-26 
usable as commands, III: 3-27 

Command information structure, 
two versions of. III: 4-23 
use of with EPF$RI]N, III: 4-24 



Command interface, III: 1-10 
for one program invoking 

another. III: 1-11 
levels of complexity. III: 
1-10 

Command invocation, ( See also 

command processing 

information) 
calling sequence. III: 3-2 to 

3-4 
command line. III: 1-12 
defined, III: i-ii 
error codes for. III: 3-5 
limits on. III: 1-13 
severity code, III: 1-12 

Coramaai level, III: 1-17, 5-2 
ijreadth, I: 5-3 
defined. III: 1-17 
listener. III: 1-17 
listener, the. III: 5-2 
mini-command level. III: 1-18, 

5-14 
multiple. III: 5-3 
releasing. III: 5-5, 5-6 
search rules, II: 3-2 

Command line, 
accepted ty EPF, III: 1-12 
as argument in calling 
sequence. III: 3-3 
as argument to CP$, III: 4-II 
use of tilde (~) in front of, 
III: 4-11 

Command line reader, III: 1-19 
recursive invocation of. III: 
6-1 

Command names, determined "by 
command processor. III: 2-4 

Command preprocessor. III: 1-21 

Command Procedure Language (CEL), 
II: 2-2 

Command processing information, 
III: 1-13, 3-15, 3-16, 3-18 
-AGAT l>it. III: 3-21, 4-33 
-BOOTOHJDP hit. III: 3-21 
command name. III: 3-19 
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Commaiii processing inf oimation 

(contioued) 
CPL local vaxiables pointer, 

III: 3-20 
-DIRBCrrCRY bit, III: 3-21, 

4-33 
-FILE bit, III: 3-21, 4-33 
iteration bit. III: 3-22 
-KBF bit. III: 3-21, 4-33 
sample program, III: 3-22, 

4-51 
-SBCaiENTJDIREGraRY bit. III: 

3-21. 4-33 
treewalk bit. III: 3-22, 4-31 
-VERIFY bit. III: 3-21, 4-33 
version. III: 3-19 
-WAIKJFRCM bit. III: 3-22 
-WAIKJTO bit. III: 3-22 
wildceaxi bit, III: 3-22, 4-31 

CJommand processor. III: 1-20, 

2-1 
ABEREV cammand, handling of, 

III: 2-3 
actions when invoked ty CP$, 

III: 4-7 
calls STD$CP, III: 1-20 
caramajad separator character 

(;), haudling of. III: 2-3 
determines command name, III: 

2-i 
determines command type. III: 

2-5 
evaluates function references, 

III: 2-i 
evalxiates variable references, 

III: 2-4 
expression evaluator. III: 

1-20 
inhibition of features. III: 

2-2, 2-5 
interface with commands. III: 

1-10. 1-11 
invocation modules. III: 2-7 
invokes commands. III: 2-7 
iteration, handling of, III: 

2-5 
listener. Ill: 1-17 
listener, the. III: 5-2 
name generation, handling of, 

III: 2-7 
-NO_VERIFY, hftTYiling of, III: 

2-7 



CommaiKi processor (continued) 
recursive invocation of. III: 

6-1 
removes null totoens. III: 2-4 
RESUME coramaad, III: 2-5 
sequence of actions. III: 2-1 
simple iteration, handling of, 

III: 2-5 
stacfc, viewed with DOMP_STACK. 

Ill: 5-2 
treewalMng, hantil 1 ng of. III: 

2-6 
-VERIFY, handling of. III: 2-7 
wildcards, hn,nd1ing of. III: 

2-6 

Command prompter. III: 1-19 

Commajxi separator character, 
III: 2-3 

OCMIAND$, search list, II: 3-2. 
3-7 

Commajxi-infonnation argument, 
for EPFSRDN subroutine. III: 
4-23 

Ckaranand-line axgument, 

for EPF$RUN subroutine. III: 
4-22 

Commands, II: 2-1 

DDMP_STACK, III: 5-10 
external , III : 1-10 
format of. Ill: 4-3 
ICE, III: 1-16, 5-11 
INITIAU:ZEJCJCMMAND_J3^VIRCNMENT, 

III: 1-6, 5-11 
interface with command 

processor. III: i-ii 
internal. III: 1-9, 4-3 
RDY, III: 5-i 
recursive invocation of. III: 

6-1 
REENTER, III: 5-12 
RE[jEASE_JLEVEL, III: 5-5 
REN. Ill: 5-12 
resident in GMENOO, III: 4-2 
resident within PRDDS. Ill: 

4-2 
RI£, III: 5-5 
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Camnands (oontinued) 
START, III: 5-14 
usaJDle as coinmand. functions, 
III: 3-27 

Common area, I: 3-10, 8-1 
defining a shaxed, I: 8-2 
initialization of, I: 3-11 
treatment of ty BIND, I: 3-11, 
3-15 

Common bloclics and d3mainic link, 
I: 2-4 

Ccanmon storage, 

releasing. Ill: 5-6 

OCMD$$ subroutine, II: 4-7 

Compilers , 

searoh rule support, II: 3-8 
seaxGliing for inc3lude files, 
II: 3-8 

Complete calling sequence, III: 
3-26, 3-29 

Compressed files, II: 5-4 

Conditions , 

ANY$, III: 1-22 
LINKAGE_ERROR$ , III: 1-14 
NO_AVAIL_SBGS$ , III: 1-16 
PAGING_DEVIGE_FDLL$ , III: 1-16 
QUITS, III: 5-15 
RKENTKRS, III: 5-12 
STC»AGE, III: 1-15 
SYSTEM_STCRAGE$ , III: 1-15 

OaNTROL-P (Quit), III: 5-15 
( See also QUITS ooixiition) 

CP$ subroutine, I: 3-16; III: 

1-20, 3-1, 4-9 
actions of. III: 4-7 
calling sequence. III: 4-10 
command-line argument of. III: 

4-11, 4-14 
cpl-local-vars-ptr , III: 4-13, 

4-15 
error codes retximed by. III: 

4-17 
error-code axgmnent of. III: 

4-12, 4-14 



CP$ subroutine (continued) 
flags argument of, III: 4-12 
ftn-fcn-ptr axguinent of. III: 

4-14 
function-call bit. III: 4-12, 

4-14 
i nhi bit-evaluation bit. III: 

4-12, 4-15 
rtn-fcn-ptr argument. III: 

4-13 
severity-code axgument of, 

III: 4-12, 4-14 
used for command invocation, 

III: 4-9 
\ased for function invocation, 

III: 4-13 
used for program invocation, 

III: 4-9 
used for recursive invocation, 

III: 4-54 
when to use it. III: 4-6 

CPL, II: 2-2 

abilities of programs. III: 

4-^ 
command environment support for 

programs, III: 1^ 
functions and program EPFs, I: 

1-16 
program invoker. III: 2-7 
variables pointed to ty 

cpl-local-vaxs-ptr , III : 

4-15 
variables used ty command 

functions. III: 3-27 

cpl-local-vaxs-ptr , 

argument to CP$, III: 4-13 

GE?EA$$ subroutine, II: 2-24, 4-7 

GEIEATE command, II: 2-24 

Creating a file, II: 2-26 

Creating file directories, II: 
2-24 

Creating file system objects, 
II: 2-24 

CEIEFWS subroutine, II: 2-25, 4-7 
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Current attach point, II: 1-17, 
2-13, 4-1, 4-6, 4-9, 4-13 
seaxnhing, II: 3-17 

Current directory, II: 1-17 
opening, II: 4-21, 4-22 

Current object position, II: 
1-23 

Cylinrjers, II: 1-5 



DAM (Direct Access Method), II: 
1-15 

DAM segment directory, II: i-25 

Da,ta. II: 1-2 
field, II: 1-2 
file, II: 1-2 
objects, II: 1-2 
record, II: 1-2 
storage, II: 1-2 

Data file, 

extending, II: 6-42 
positioning in, II: 6-42 
reading, II: 6-42 
retrieval, II: 6-43 
storage, II: 6-4=3 
writi^, II: 6-12 

DATA segment, I: 3-7, 3-10, 3-19 
access to, I: 3-16 

Data types, 
used in subroutine calls, 0: 
1-3 

Database, 
management, II: 6-1 

Date and Time Created (nrc) 
attribute, II: 1-33 

Date aixl Time Last Accessed (DTA) 
attribute, II: 1-32 

Date and Time Last Backed Up 
(DIB) attribute, II: 1-35 



Date and Time Last Modified (DIM) 
attribute, II: 1-33 

Deallocation, 
dynamo memory, I: 3-32 
library EPPs, I: 3-32 

Debugging an EPF, 

BIND coramajJd, I: 1-18 
DBG commaal, I: 3-35 
DDMP_STACK command, I: 1-18 
LIST_EPF caramaai, I: 1-18 
Other useful commands, I: 1-19 

. setting breakpoints, I: 1-18 
VPSD command, I: 1-18, 9-6 

Debugging information in EPFs, 
I: 3-3, 3-7 

Decoder, command features, III: 
1-21 

Default on-unit, III: 1-22 
actions on catching (JUITS, 

III: 5-15 
recursive invocation of, III: 

6-1 

Default search rules ( See SjTSten 
seaxch rules) 

DELETE command, II: 2-38 

Deleting a file, 

within a segment directory, 
II: 6-23 

Deleting file ss^stem objects, 
II: 2-37 

Detailed command calling 

sequence. III: 3-15, 3-17 

Device Ads, II: 7-1 

DF_UNIT_ (See Default on-unit) 

DIR$CR subroutine, II: 2-24, 
6-30, 6-32, 6-34 

DIRSLS subroutine, II: 2-31 
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DIR$RD sulxroutine, II: 1-29, 
2-31, 6-30, 6-39 to 6-11, 
8-1, 8-3 

DIR$SE subroutine, II: 2-31 

Direct Access Method (DAM), II: 
1-15 

Directory, II: 1-3 

attaching to, II: 1-16 
creating file, II: 2-25 
current, II: 1-17, 4-7 
current file tmit, II: 1-29 
duplicate names, II: 3-21 
file, II: 1-8, 1-25 
home, II: 1-13, 1-20, 4-7, 4-9 
home file \mit, II: 1-29 
opening file, II: 2-27 
origin, II: 1-8, 4-1 
origin file unit, II: 1-29 
password, II: 1-18 
quota, II: 1-39 
quota information, II: 9-4 
reading. II: 2-31 
searching, II: 3-7, 3-8 
searching partitions for, II: 

3-6 
segment, II: 1-9 
top-level, II: 1-8 
working, II: 1-13 
writing, II: 2-34 

-DIRECTCRY bit. III: 3-21, 4-33 

Disk, II: 1-5 

( See also Disk partition) 
formatting, II: 1-7 
full, II: 7-11 
logical, II: 1-7 
organization, II: 1-5, 1-7 
physical, II: 1-5, 1-7 
storage, II: 1-2 

Disk partitions, II: 1-5 
as argument, II: 2-16 
search all, II: 3-16 
search named only, II: 3-16 
searching, II: 3-6, 3-21 

Disk record availability table 
(DSKRAT), II: 1-7 

Disk-shut-down flag, II: 1-26 



Displa3ajig common area addresses, 
I: 3-15 

DC3MP_STAlCK commaixi, I: 9-9; 

III: 5-10 
-ONJJNITS option. III: 5-2, 

5-11 
to display call history of a 

program, III: 5-10 
to track program errors. III: 

1-18 
to view command processor 

stack. III: 5-2 
to view your stack, III: 5-10 
use at mini-command level, 

III: 5-14 

Duntped bit, II: 1-38 

Dumped/not-dvunped attribute, II: 
1-38 

Dynamic link, I: 5-5 

corainan blocks and, I: 2-4 
definition of, I: 2-2 
sample session, I: 2-4 
snapping, I: 2-3, 3-21 
to entry points in PRIMOS, I: 

3-22 
to entrypoints in Application 

Library, I: 3-24 
to entrjTpoints in PRIMOS, I: 

3-26 
to static-mode libraries, I: 

3-28 

Dynamic linking mechanism, I: 
1-3, 2-1, 3-6, 3-19 
advantages, I: 2-1 

Dynamic links, 

resolving, using ENTRY$, II: 
3-9 

E^mamic memory, I: 1-9 
deallocation of, I: 3-32 
in EPFs, I: 3-3 

Dynamic resources. III: 6-2 

I)ynamioally allocated storage, 
releasing. III: 5-6 
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EKNT, ( See also IDynajnic links) 
as a siibcaramand. of BIND, I: 
5-5 



E 



BOB (entry control blook), I: 
1-3 
information contained in, I: 

1-i 

EDAC corranaal, II: 2-22 

EDB binary editor, I: 10-2 to 
10-6 
error messages, I: 10-5 
obsolete commands, I: 10-5 
suboommands , I : 10-3 

EDIT_AOCESS command, II: 2-22 

End of file, 

positioning to, II: 5-15 

ENT$KD subroutine, II: 2-31, 
6-30, 8-1 to 8-3 

ENTO,Y$, II: 3-2. 3-9 

[home_dir] toejTword, II: 3-17 
-prljnos_direct_entries kieyword, 

II: 3-17 
SR, I: 1-3 
-static_jnode_libraries keyword, 

II: 3-16 

Entry control block (See ECB) 

ENTRYNAME, 

as a subcommand of BIND, I: 
3-15 

Entrypoint, I: 2-2 

as a subcommand of BIND, I: 

6-8 
determining, for library EPPs, 

I: 6-5 
invocation, I: 3-19 
main, of a program EPF, I: 

5-4, 5-5 
modif57ing the search list of, 

I: 6-12, 6-13 
reseived names, I: 6-5 



Entrypoint (continued) 

searching EPF libraries for, 

II: 3-9 
searching PEIIMDS S5?stem calls 

for, II: 3-17 
searching static-mode libraries 

for, II: 3-16 
subroutine, declaring, I: 6-8 

Entrypoint search list, I: 6-12, 
6-13, 6-32 
( See also Seaaxih list) 
advanced use of, I: 6-37 
default, I: 6-32 
examining, I: 6-38 

EPF, ( See also Library EPF; 

Process-class library EPF; 

Program EPF; Program-class 

library EPF) 
benefits of, I: 1-9 
cache, I: 1-18, 3-34 
coding guidelines for, I: 7-1 
copies of link frame, I: 3-4 
debugging information, I: 3-3 
debugging of, I: 1-18, 3-35 
definition of, I: 1-2 
dynamic memory, I: 3-3 
id. III: 4-24 
information contained in, I: 

1-18 
invocation by CP$ subroutine, 

I: 3-16; III: 4-9 
invocation by EPFSINVK 

subroutine, III: 4-27 
invocation by EPP$IUIN 

subroutine, I: 3-16; III: 

4-20 
invocation, forms of, I: 3-16 
invoker. III: 2-7 
library, I: 1-3 
life of an, I: 3-5 to 3-34 
linkage text, I: 3-2 
mapped, I: 3-16 
mecihanism, I: 3-1 
most flexible format for 

programming instructions, 

III: 4-^ 
multiple invocations of, I: 

3-34 
new versions, I: 1-2, 3-30, 

3-34 
old versions, I: 1-2, 3-34 
organization of, I: 3-2 
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EPF (continued) 

prooedure code, I: 3-2 
program, I: 1-3; II: 1-24 
program, calling sequence, 

III: 3-1 
reason for, I: 1-4 
recursive invocation of, III: 

4-54 
removing from memory, I: 1-16, 

3-6, 3-30 
restrictions on writing in FMA, 

I: 7-10 to 7-16 
.RPn suffix. I: 1-2 
.RUN suffix, I: 1-2 
running a remote, I: 3-36 
simultaneous vise of, I: 3-35 
stack space, I: 3-3 
( See also Stack frame) 
static information and, I: 4-7 
suspending and restarting, I: 

1-17 
termination of, I: 3-6, 3-30, 

3-31 
types of, I: 1-3 
•unmapping, I: 3-34 
writing in Mgji-level 

languages, I: 7-1 
writing in PMA, I: 7-2 

EPF calling sequence, 
arguments for. III: 3-1 
ccramarxi sequence. III: 3-2 
program sequence. III: 3-2 

EPF generation and use, 
pihase 1 (compilation or 

assemikxLy), I: 3-7 
phase 10 (removal), I: 3-33 
phase 10 (removal from memory), 

III: 4-37 
pihase 2 (linking), I: 3-7 
pihase 3 (invocation), I: 3-15 
pihase 4 (mapping), I: 3-16 
pihase 5 (linkage allocation), 

I: 3-16; III: 4-34 
pihase 6 (linkage 

initialization), I: 3-19; 

III: 4-34 
pihase 7 (entrypoint 

invocation), I: 3-19; III: 

4-37 
pihase 8 (dynamic links 

snapped), I: 3-21 
pihase 9 (termiiiation) , I: 3-30 



EPF generation and use 
(continiied) 
pihases in, I: 3-6 
sample program, III: 4-47 
stages in, I: 3-5 

EPF libraries, 

searching, II: 3-9 

EFF$ALLC subroutine, I: 3-6, 
3-16; III: 4-34 
calling sequence. III: 4-35 
error codes, III: 4-42 

£PF$CPF subroutine. III: 4-31 
calling sequence. III: 4-32 
epf-info stmcture. III: 4-31 
error codes. III: 4-42 
sample program using. III: 

4-51 
wildcard bit. III: 4-31 

EPFSDEL subroutine, I: 3-6, 
3-33; III: 4-37 
calling sequence. III: 4-39 
error codes. III: 4-44 

EPF$INIT subroutine, I: 3-6, 
3-19; III: 4-34 
calling sequence. III: 4-36 
error codes. III: 4-43 

EPFSINVK subroutine, I: 3-6, 

3-19; III: 3-1, 3-2 
calling. Ill: 4-37 
calling sequence. III: 4-38 
compaxed with EPF$RUN, III: 

4-8 
error codes. III: 4-44 
invoiking EPFSALDC before using, 

III: 4-34 
invoking EFF$CPF before vising, 

III: 4-31 
invoking EPFSDEL after using, 

III: 4-37 
invoking EPF$INIT before using, 

III : 4-34 
invoking EPF$MAP for. III: 

4-29 
key argument. III: 4-34 
opening file for. III: 4-28 
steps in using. III: 4-27 
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EPF$INVK sutooutine (continued) 
\ised for recursive invocation, 

III: 4-54 
When to Tise it. III: 4-8 

EPFSMAP sutooutine, I: 3-6, 
3-16; III: 4-29 
access argument, III: 4-29 
calling sequence. III: 4-30 
code argument. III: 4-29 
error codes. III: 4-40 
key argument. III: 4-29 
vmit argument. III: 4-29 

EPF$RUN sutooutine, I: 3-5, 

3-16; III: 3-1, 4-18 
actions of. Ill: 4-8 
calling sequence of. III: 4-21 
cthecdting retxamed code value, 

III: 4-25 
Gheoking returned comniaQd 

Statxis, III: 4-25 
command-information structure, 

III: 4-23 
command-line argument. III: 

4-22 
EPF id. III: 4-24 
error codes returned by. III: 

4-26 
error-code argument. III: 4-22 
file-unit argument. III: 4-22 
function-call bit. III: 4-24 
invoking. III: 4-20 
key argument. III: 4-20 
opening EPF file before 

calling. III: 4-19 
rtn-fcn-ptr. III: 4-24 
severity-code argument. III: 

4-22 
Steps in \ising. III: 4-18 
used for recursive invocation, 

III: 4-54 
using and freeing returned 

valvie structuie. III: 4-25 
when to use it. III: 4-8 

EPF-info structure, III: 4-31 

Error code, 

argument of EPFSRON subroutine, 

III: 4-22 
checking code returned by 
EPF$RUN, III: 4-25 
, data base, II: 6-1 



Error code (continued) 

returned by EPF$ sidaroutines, 

III: 4-40 
returned by EPFSAUJC, III: 

4Ht2 
retiamed by EPF$CPF, III: 4-42 
returned by EPFSEEL, III: 4-44 
returned by EPF$INIT, III: 

4-13 
returned iy EPF$INVK, III: 

4-14 
returned by EPF$MAP, III: 4-40 
returned by EPF$RUN, III: 4-26 
side effects in subroutine 

calls, 0: 1-4 
standard, use in sularoutine 

calls, 0: 1-4 

Error codes, 

alphabetical listing, 0: B-1 
E$ACBG, II: 7-12 
E$ACNF, II: 6-33 
E$ATNS, II: 8-11 
ESBARG, III: 3-5, 4-18, 4-43 
E$BFTS, II: 4-21, 6-41 
E$BKEY, III: 4-26, 4-41, 4-43 
E$BNAM, II: 4-13, 4-15, 4-18, 

6-9; III: 3-5, 4-18 

E$BOF, II: 5-19, 5-38 
E$BPAR, II: 4-12. 4-15, 4-18, 

5-28, 6-33. 7-11, 8-11; III: 

3-5, 4-41 to 4^4 
E$BUNT. II: 5-19; III: 4-26, 

4-41 
ESBVER, II: 6-33; III: 4-18, 

4-27, 4-41 to 4-14 
E$C»1ND, III: 3-5, 4-18 
E$DIRE, II: 1-25, 8-11; III: 

4-17 
E$EKFL, II: 5-13, 5-28, 5-39, 

6-15, 6-20, 6-33 
ESDTNS, II: 6-34 
E$BCEB, III: 1-14, 4-44 

E$BCF, II: 1-23, 5-19, 5-28, 

5-36, 5-38, 6-11, 6-14, 6-28, 

6-39; III: 4-17, 4-26 
E$EPFL, III: 4-41 
ESEPFT, III: 4-4:1 to 4-45 
E$EXST, II: 6-33 
ESFDEL, II: 6-23 
E$FIUS, II: 1-35, 5-12, 5-19, 

6-8, 6-20, 10^; III: 4-17 
ESFNTF, II: 4-6, 4-13, 5-13, 

5-17, 6-8, 6-33; III: 4-18 
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E$FNTS, 


II: 6-20, 6-23 


ESFUIU, 


II: 5-49 


E$IACL, 


II: 5-14, 8-11 


ESILTD, 


III: 4-42, 4-43 


E$ILTE, 


III: 4-43 


ESITHE, 


II: 4-8, 5-14; III: 


3-5, - 


i-18 


ESIVGM, 


III: 3-6 


E$MISA, 


III: 3-6 


E$MZQB, 


II: 5-14, 5-28, 5-39, 


6-9, 


S-17, 6-21, 6-33 


ESNAIT, 


II: 4-3, 4-5, 4-12, 


4-18, 


4-21, 4-22 


E$NDAM, 


III: 4-18, 4^0. 4^1 


ESNFAS, 


II: 4-15, 6-9, 6-34 


E$NINF, 


II: 5-14, 6-21; III: 


4-18 




E$NMD3, 


III: 3-5 


ESNMTS. 


III: 4-26, 4-41 


E$NMVS, 


III: 4-27, 4-41 


E$NOQD, 


II: 6-33 


E$NOVA, 


III: 4^1 


E$NR1T, 


II: 4-22, 5-13, 6-8, 


6-20, 


6-33, 6-35, 8-11; III: 


4-17, 


4-40 


ESm'tiU, 


II: 1-25 


ESmiJD, 


II: 1-25 


ESPNAC, 


II: 6-33 


E$RO0M, 


III: 4-26 


E$SHDN, 


II: 1-26, 4-3, 4-5 


ESSUNO, 


II: 6-23 


ESSWER, 


III: 4-45 


E$UIUS, 


II: 5-49 


ESDNOP, 


II: 5-19, 5-28, 5-39, 


6-5, 


6-12, 6-15, 6-28, 6-39; 


III: 


4-26, 4-40 


E$Vi'i^R, 


II: 6-9 



numerical listing, 0: A-2 

Escape sequences, 

as a static resource, III: 6—4 

ESR ( See EXPAND_SEARCH_RULES) 

Evaluation of function and 
variable references. III: 
2-4 

ExecutBLble code file, II: 3-17 

Eaecutable program format ( See 
EPF) 



EXPAND_SEARaEL_RULES (ESR) CPL 
function, II: 3-19 

EXPAND_SEARaLRUIES canmaai, II: 

3-2, 3-5, 3-19 
ATTACHS -used as default, II: 

3-6 
CCMMANDSI used as default, II: 

3-7 
partition names, II: 3-6 
pathnames, II: 3-7 
referencing_dir option, II: 

3-18 

Expanded listings, I: 9-13 

Expression evaluator, III: 1-20 

External commands. III: i-io 

External linkage information, I: 
3-7 



Faulted IP, I: 1-3, 2-2, 3-11, 
3-19, 3-21, 6-17 
how to avoid sharing, I: 4-10 
)gha.r i ng of, I: 4-9 

Field, II: 1-2 

FHiSEL sutiroutine, II: 2-38, 
4-7, 5-48 

File, II: 4-8 

appending to, II: 1-23 
closing, II: 1-30, 5-21 
( See also Closing a file) 
closing after EPFSRDN retiims, 

III: 4-25 
creating, II: 1-27, 2-26 
DAM, II: 1-25 
data, II: 6-42, 6-43 
definition, II: 1-10 
maxiraum length, II: 5-5 
open, xiising search rule 

sutxroutine, II: 3-19 
opening, II: 2-29, 5-6 
( See also Opening file) 
opening for VMFA access. III: 

4-19 
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File (continued) 

organization, II: 6-2 

pointer , II : 1-29 

positioning, II: 1-29 

reading, II: 2-33 

SAM, II: 1-25 

text, II: 1-10 

truncating, II: 1-29, 5-17 

type, II: 1-37 

unit number, II: 1-28 

iiser, II: 1-10 

writing, II: 2-35 

File access control, II: 1-16 

File access methods, II: 1-15 
Direct (DAM), II: 1-15 
Sequential (SAM), II: 1-15 

File attributes, II: 1-31, 8-1 
date and time created (DTC), 

II: 1-33 
date and time last accessed 

(DTA), II: 1-32 
date and time last bactced up 

(niB), II: 1-35 
date and time last modified 

(DOM), II: 1-33 
dumped/not-dunrped, II: 1-38 
file type, II: 1-37 
read/ write lock, II: 1-35 
setting, II: 8-6 
special/not-special, II: 1-38 

-PILE bit, III: 3-21. 4-33 

File directory, II: 1-8 
attributes, II: 6-31 
creating, II: 2-25, 6-31 
manipulating , II: 6-30 
opening, II: 6-34 
scanning, II: 6-36 

File names, 

as a static resornxje. III: 6-3 
creating dynamic file names, 

III: 6-3 
seardi order of. III: 1-10 

File sj^tem, II: i-i 

comraunicating with, II: 2-1 
interfaces, II: 2-1 
objects, II: 1-5 
seaxch, II: 1-14 



File t37pe attribute, II: 1-37 

File imit, II: l-23, 2-8 

abnormal terminate, II: 1-30 
accessing, II: 1-23 
calculated access to object, 

II: 1-26 
closing, II: 1-23 
current object position, II: 

1-23 
disk-shut-<iown fla^, II: 1-26 
dynamic number allocation, II: 

1-27 
multiple opens, II: 2-9 
normal tenninate, II: 1-30 
object type, II: 1-25 
object-modified flag, II: 1-25 
open mode, II: 1-24 
opening, II: 1-23 
position in g, II: 1-23 
read/write lodk, II: 1-26 
static ntnnber allocation, II: 

1-28 



File unit argument, 
of EFF$RUN subroutine, 
4-22 



III: 



File \mit nimber, 

as argument to EPFSMAP, III: 
4-29 

File units, 
as a static resource. III: 6-1 

Filename, 

expand to full pathname, II: 

3-5 
getting pathname for, II: 3-2 

Fixed-length record file, 
blocking factor, II: 5-44, 

5-45 
calculating record position, 

II: 5-46 
end of file, II: 5-45 
format, II: 5-44 
incomplete read/write, II: 

5-37 
positioning, II: 5-31, 5-37. 

5-12 
reading, II: 5-31 
record length, II: 5-44 
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Flaed-lengtli record file 
(continued) 
writing, II: 5-31 
writing records to open file 
unit, II: 5-39 

Fixed-length records, II: 5-4 
advantages, II: 5-4 

Fixed-nedia disks (FMDs) , II : 
1-5 

Formatting a disk, II: 1-7 

FRE$RA subroutine, III: 4-45 
calling sequence. III: 4-46 
vdien to \ise it. III: 4-8 

Freeing memory, 
via FRE$RA subroutine. III: 

4-45 
via ICE cammaod, III: 1-16 

Freeing segments of R-nwDde 
programs, I: 1-7 

Full pathname, 
determining, II: 4-18 

Function invocation, ( See also 
Commguxi function invocation) 
command line. III: 1-12 
defined, III: l-ll 
returned cihaxacter string, 

III: 1-12 
severity code. III: 1-12 
via EPFSINVK, III: 4-27 
via EEFSRUN, III: 4-18 

Function references, evaltiation 
of. III: 2-4 

Function-call, 

argument, III: 3-9 

bit. III: 4^12, 4-14, 4-24 

Functions, ( See also Command 

functions^ 
command environment support 

for. III: 1-7 
defined, III: 1-9, 1-12 
Interaction with command 

processor. III: l-ll 
invocation of. III: 1-11 



GPAS$$ subroutine, II: 4-7 

GPATH$ subroutine, II: 4-7, 
4-18, 4-20, 4-24, 6-43 



H 



Home attach point, II: 1-16, 
2-13, 4r-3, 4-13 

Home directory, II: 1-16, 4-9 
searching. II: 3-17 



I-mode programs, I: 1-5 

ICE coraDnand, III: 5-11 
use of. III: 1-16 

Imaginary addresses and EEP 
sharing. I: 1-14 

Impure code, I: 1-13 
separation of pure code from, 
I: 1-12. 7-2 

IMPURE segment, I: 3-7, 3-10, 
3-19 
access to, I: 3-16 

INGU3DE$, II: 3-2, 3-8 
if doesn't exist, II: 3-8 
[referenciag_dir] keyword, II: 
3-18 

IncltJde file, 
searcGiing directories for, II: 
3-8 

iTviirect pointer (See IP) 

Inhibit-evaluation bit. III: 
4-12. 4-15 

Ihhibiticm of command processor 
features. Ill: 2-5 
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Initial attach point, II: 2-13 
searching, II: 3-17 

Initialization, 

of linkage areas, via EPF$INIT, 

III: 4-34 
Of variables, I: 1-19 
shared data, I: 8-3, 8-4 

Initialize process, 

seaxGh list created, II: 3-2 

search list deleted. II: 3-6 

seaxch list set, II: 3-11 

search rule set, II: 3-^ 

INITIALIZE jXMMAJCLENVIRattlENT 
corainand. III: 5-11 
nse of. III: 1-16 

Interactive visers, 

command environment support 
for. III: 1-2 

Intemal commands. III: 1-9 

Internal-command invdker. III: 
2-7 

Interprocess coraraunication, 
caveats, II: io-4 
competing servers, II: 10-7 
concuxrent access to data base, 

II: 10-10 
general concepts, II: 10-1 
models, II: 10-5 
read/write locks, II: 10-2 
transaction file, II: 10-5 
two-process transaction models, 

II: 10-9 

Invocation, ( See also Coramaai 

invocation; Function 

invocation; Program 

invocation) 
limits on. III: 1-13 
of commands, III: 1-11 
of commands, iyy command 

processor. III: 2-7 
of functions. III: 1-11 
of jxrograms. III: 1-10 
of programs, from within 

programs. III: 4-1 
recursive. III: 4-54 



Invoking an EPF, I: 1-3, 3-15, 
5-1, 5-2 
sample program, III: 4-47 
subroutines for, I: 3-5 

IP (indirect pointer), I: 1-3, 

3-7 
faulted. I: 1-3, 2-2, 3-11, 

3-21, 6-17 
how to avoid sharing faulted, 

I: 4-10 
resolution of at runtime, I: 

3-10 
sharing of faiilted, I: 4-9 
treatment of by BIND, I: 3-10, 

3-11 

IPC ( See Interprocess 
communication) 

Iteration, 
handling of by command 
processor, III: 2-5 
simple. III: 2-5 

Iteration bit. Ill: 3-22 

Iteration processor, 
recursive invocation of. III: 
6-1 



K 

KSGETU key. III: 4-19 
K$INVK key. III: 4-20 
K$INVK_J3EL key, 111:4-20 
K$RESTCRE_CaaY key. III: 4-20 
K$VMR key. III: 4-19 



Key, 






KSBKUP, 


II 


5-11 


Kscros, 


II 


2-37 


UGJBA, 


II 


4-19 


K$I1KI.K, 


II 


2-39 


K$Ut'LT, 


II 


8-9 


KSIUPB, 


II 


8-7, 8- 


K$m'A, 


II: 


8-7 


K$nrc. 


II: 


8-7 
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Key (continued) 



K$nnM 
KSEXCL 
K$EXST 
K$FREE 
K$FULL 
KSGETU 

6-5 
K$HGMA 
KSINIA 
K$INIT 
K$MSIZ 
KSNCAM 
K$NDAM 
KSNONE 
K$NSAM 
K$NSGD 
K$NSGS 
KSPOSN 
K$FR£A 
K$PROT 
K$RDWR 

6-18 
K$RKAD 

6-4. 
K$RPOS 

KSSDL, 
K$SETC 

4-15 
KSSETH 

4-15 
K$TRHC 

K$xjpnr 

K$VMR, 
K$WRIT, 
6-18 



II: 8-7 
II: 8-9 
II: 5-47 
II: 2-32, 
2-32, 
5-12, 



II: 
II: 



II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 
II: 



4-19 

4-19 

1-29, 

2-34 

5-12, 

5-11, 

8-9 

5-11, 

5-12, 

5-12. 

5-36 

5-36 

8-7, 



II: 5-11, 

II: 5-11. 
6-18, 6-39 

II: 5-36 

II: 8-7. 
II: 8-7 

II: 2-16, 
4-16 

II: 2-16, 
4-16 

II: 5-36 

II: 8-9 
II: 5-11. 

II: 5-11, 



6-26 
6-26 
5-48, 5-i9, 



6-39 

6-22 
6-22 

6-22 

6-5. 6-22 
6-5, 6-22 



8-9 
5-^48, 6-4, 

5-36, 5-45, 



8-9 
4-1, 4-12. 
4-1, 4-12, 



6-18 
5-36, 5-i8, 



Key argument, 

for EPF$INVK subroutine. Ill: 

4-34 
for EPF$MAP subroutine. III: 

4-29 
for EPF$RON subroutine. III: 

4-20 
use in subroutine calls, 0: 

1^ 



LB ( See Tankage base) 



LB$SET subroutine. III: 3-27 

KEBEOB binary editor, I: 10-1 

IJ3RARY, 

as a subcommand of BIND, I: 

3-11 
external references resolved 

by, I: 3-11 

Library EPF, I: 1-3, 1-9 
assemb l ing the IMA entrypoint 

file for, I: 6-10 
. building a FMA entrypoint file 

for. I: 6-8, 6-9 
Ghoosing the right type of, I: 

6-4, 6-14, 6-15 
coding a subroutine for, I: 

6-4 
compiling a subroutine for, I: 

6^ 
deallocation of, I: 3-32 
definition of. I: 6-2 
determining class requirements 

of, I: 6-29 
determining entrypoints of, I: 

6-4 
installing a library file, I: 

6-11 
installing the library EFF, I: 

6-11 
invoking. I: 1-3 
linking subroutines of, I: 6-7 
mectianism, I: 6-39 
modifying the entrypoint search 

list, I: 6-12 
prooess-dass, I: 3-32. 3-33 
program's view of, I: 6-4 
program-class. I: 3-32, 3-33 
programmer's view of, I: 6-2 
restriction on class mixing of. 

I: 6-16 
restriction on use of language 

I/O. I: 6-17 
steps in building, I: 6-2, 6-4 

to 6-13 
Storage allocation issues, I: 

6-41 
storing data in linkage area 

of. I: 6-17 
using DBG on, I: 6-30, 6-31 
using EDB to generate a library 

file, I: 6-10 



Ii idex-17 



Third Edition 



Mvanoed Programmer's Guide, Voliate 



Limits on calling program EPFs, 
I: 5-3 

Link frame, I: 3-i, 3-5, 3-10 

T linkage, 
area, I: 3-32 
area, storing data in, I: 

6-17, 6-18 
base, I: 3-4 
fault, I: 2^ 

initialization, I: 3-19, 6-18 
releasing areas. III: 5-6 
text, I: 3-7 
text, in EPFs, I: 3-2 
text, in subroutines, I: 3-4 

LrNKAGE_ERRGR$ corxiition. III: 
1-14, 1-15 

Linking, 

loaders, history of, I: 1-4 
purpose of, I: 3-7 
utilities, I: 1-2 

lASIJ^CCESS cammand, II: 1-20 

LIST_EPF oammaai, I: 9-3 

LISTJLBCETS, 

use of. III: 1-14 

LIST_SEARGELRULES corainand, II: 
3-12 
disabled searcili rules, II: 
3-15 

Ij:ST_SBQffiNT, 

use Of , I: 9-5; III: 1-14 

Listener, III: 1-17. 5-2 
and mini -command level. III: 

5-14 
multiple invocations. III: 5-3 
recursive invocation of, III: 

6-1 

LOAD, I: 1-2, 1-i 
Local objects, II: 1-5 
Login ( See Initialize process) 
Long prompt. III: 5-5 



Lower-level Directory, II: 1-9 
LSR (See LrST_SEARCEU«ILES) 
LVSGET subroutine, III: 3-27 



M 



MAIN, 

as a subcQmmand of BIND, I: 
3-15, 5-5 

MAKE commaixi, II: 1-7 

MAP, 

as a subcommand of BIND, I: 
9-5 

Mapping an EPF, I: 3-16 

Maps and addresses, I: 9-1 

Master file directory (MFD), II: 
1-8 

Memory, 

allocation of, I: 1-10, 1-11 
dynamic, I: 1-9 
releasing via FRE$RA 

subroutine. III: 4-45 
static, I: 1-9 
system-wide limits on. III: 

1-15 

MFD (master file directory), II: 
1-8 

Mini -command level. III: 1-18, 
5-14 

Multiple invocations of an EPF, 
I: 3-34 



N 



Name generation, 

handled by command processor, 
III: 2-7 
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Names of caramaiJds , determined ty 
corainajQd processor, III: 2-4 

New Featiires, 

Revision 20.0, 0: C-8 

Revision 20.2, 0: C-? 

Revision 21.0, 0: C-3 

Revision 22.0, 0: C-1 

ND_AVAIL_SBGS$ cxjniitian, III: 
1-16 

-NO_VERIFY option, 
handled by cammand procsessor, 
III: 2-7 

Null tokens, removal of from 
commaDd line. III: 2-4 

NWS filename prefix, III: 4-4 

NX$ filename prefix, III: 4-4 



Qbjecft, 

closing, II: 2-36 

creating, II: 1-15, 2-10 

creating file sjTStem, II: 2-24 

current position, II: 1-23 

deleting, II: 2-12, 2-37 

file sjrstem, II: 1-2, 1-5 

local, II: 1-5 

name, II: 1-11, 2-7, 4-8 

naming, II: 1-15 

opening, II: 2-11 

opening file system, II: 2-27 

reading, II: 2-11, 2-30 

remote, II: 1-5 

simple name, II: 4-6 

specifjTing names, II: 2-7 

type, II: 1-25 

writing, II: 2-12, 2-34 

Object file, I: 3-7 

Object nami.ng conventicnis, II: 
1-15 
absolute pathname, II: 1-12 
corapanents, II: 1-11 
full pathname, II: 1-14 



Object naming conventions 
(continued) 
relative pathname, II: 1-12 
simple pathname, II: 1-13 

OPEN commajad, II: 2-27 

Open mode, II: 1-24 

Opening, 
EFF file for VMFA access. III: 

4-19 
file for VMFA read, possible 

error codes. III: 4-40 

Opening a file, II: 1-26, 2-29 
file pointer, II: i-29 
file unit n-umber, II: 1-28 
file unit number allocation, 

II: 1-27 
using seaxcii rules, II: 3-5 
within a segment directory, 

II: 6-17 

Opening a file directory, II: 
2-27 

Opening a file system object, 
II: 2-27 

ORIGIN command, II: 2-13 

Origin directory, II: 1-8 
searching, II: 3-17 



PAGINC5JDEVICE_F0LL$ condition, 

III: 1-16 

Partition ( See Disk partitions) 

Password directory, II: 1-18 

Pathname, II: 1-11 
absolute, II: 1-12 
full, II: 1-14, 4-18 
partial, II: 3-2 
relative, II: 1-12 
simple, II: 1-13 

FB (See Procedure, base) 
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PGL instruction, I: 3-4, 3-7, 
3-19 

Perf onnanoe , 

disk access, II: 3-3 

Permissions (See Access Control 
Lists (AOL^U 

PHAHT$ subroutine, II: 4-7 

Phantoms, 

search lists of, II: 3-2 

PHNTM$ subroutine, II: 4-7 

FMA. 
restrictions for EPP execution, 

I: 7-10 
writing EPFs 1b, I: 7-2 to 
7-10 

Pointer, ret-uxned value. III: 
3-9 

Positioning a file, II: 1-29 

PRIMOS, 
error codes ordered. 

alphabetically, 0: B-1 
error codes ordered. 

n-uinerically, 0: A-2 
mnemonics for error codes, 0: 

A-1 
Revision 20.0 new features, 

C-8 
Revision 20.2 new features, 

C-7 
Revision 21.0 new features, 

C-3 
Revision 22.0 new featiires, 

C-1 

PRIMOS commands, 

searcihing for, II: 3-7 

PRIMOS file system, 
elements of, II: 1-4 
ti-ee structure, II: 1-5 

PROG segment, I: 3-7, 3-10 
access to, I: 3-15 



Procedure, II: 1-3 
base, I: 3-4 
code in EPFs, I: 3-2 
code in subroutines, I: 3-4 
frame, I: 3-4 

main, of a program ERF, I: 5-4 
itctnagement , I: 3-4 
text, I: 3-7 

Procedure code storage, 
releasing, III: 5-6 

Process-class llbraxy EPF, I: 
3-32, 3-33, 6-41 
Choice of, I: 6-14 
link sequence for, I: 6-7 
restrictions on \ise of, I: 

6-14 
using for shaxed data, I: 8-5 

Program, 

I-mode, I: 1-5 
R-mode, I: 1-4, 1-5 
S-mode, I: 1-5 
static-mode, I: 1-4 
V-mode, I: 1-5 

Program ERF, I: 1-3, 1-9 
arguments to, I: 1-16, 5-4 
calling sequence. III: 3-1 
commajQd line preprocessing, I: 

1-17 
GEL functions, I: 1-16 
data retiirned from, I: 5-3 
data supplied to, I: 5-3 
definition of, I: 5-1 
invoking, I: 1-3, 5-1, 5-2 
invoking program's view of, I: 

5-2 
limits on calling, I: 5-3 
main entiypoint of, I: 5-4, 

7-2 
main procedure of, I: 5-4 
programmer's view of, I: 5-1 
stacking of, I: 1-17 
user's view of, I: 5-2 
writing the main program, I: 

5-4 

Program Invocation, 
calling sequence, III: 3-2, 

3-3 
deciding whidh interface to 
use. III: 4-6 
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Program invocation (continued) 
defined. III: i-io 
from witlain programs, III: 4-I 
limits on. III: 1-13 

Program-class library EPF, I: 
3-32, 3-33, 6-^0 
Glioioe of, I: 6-14 
link sequence for, I: 6-7 

Programs, 

command environment support 

for. III: 1-6 
format of, III: 4-3 
interface with command 

processor , III : 1-10 
invoking programs from. III: 

4-1 
resident on disk. III: 4-2 

Prompter, command, III: 1-19 

Prompts, set ty RCJy command, 
III: 5-5 



Quota, II: 1-39 
directory, II: 9-1 
MFD, II: 9-2 

Quota exceeded, II: 7-11 



R 



R mode, I: 1-4 

R-mode programs, I: 1-4, 1-5 
freeing segments of, I: 1-7 

-KBF bit. III: 3-21, 4-33 

RTTTiTWS subroutine, II: 5-2, 5-a4 
to 5-26, 5-31 

REiy coramaoi, III: 5-4 

in KGIN.CEL files. III: 5-5 
to specify system prompts, 
III: 5-4 



PRTN instruction, I: 3-4 

PRWF$$ subroutine, II: 2-35, 
5-2, 5-16 to 5-18, 5-20, 
5-29, 5-31 to 5-42 

Pure code, 

separation of intpure code from, 

I: 1-12, 7-2 
sharing of, I: 1-13 



Read/write lock attribute, II: 
1-35 

Read/write locks, II: 1-26 
documenting, II: 10-2 
EXGL, II: 10-2 
file, II: 10-2 
per file, II: 10-3 
safety check, II: 10-2 
system, II: 10-2 
UPDT, II: 10-2 

Reader, command line. III: 1-19 



Q$READ subroutine, II: 9-1, 9-3 

Q$SET subroutine, II: 9-5 

QOIT$ condition. III: 5-15 
as handled hy default on-unit, 

III: 5-15 
how your program can handle it, 

III: 5-15, 5-16 
resignaling the condition, 

III: 5-16 
sample program, III: 5-I6 



Reading file ss^stem objects, II: 
2-30 

Record, II: 1-2 
date, II: 1-2 
fixed-length, II: 5-4 
logical, II: 1-7 
physical, II: 1-7 
text, II: 1-2 
variable length, II: 5-3 

Recursive command environment, 
III: 6-1 
creating dynamic screen 
handlers for. III: 6-3 
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Recursive commamd environinent 

(continued) 
file units not recursive, III: 

6-1 
generating dynamic file names 

for, III: 6-3 
haaJling terminal escape 

sequeixies in, III: 6-4 
limits on use of cache attach 

point. III: 6-2 

Recursive invocation of EPFs, 

III: 4-54 
behavior of static storage 

during. III: 4-54 
redirecting terminal I/O 

during. III: 4-55 

REENTER command, III: 5-12 

used with RELEASE_IEVEL 

command. III: 5-13 

REENTER! condition. III: 5-12 

Referencing directory, II: 3-18 

Relative pathname, II: 1-12 

RELEASE_LEVEL command. III: 5-5, 

5-7 
releasing to a particular 

level. III: 5-7 
resources released ty, III: 

5-6 
used to restart a suspeiaded 

program, I II: 5-7 
used with REENTER command, 

III: 5-13 

Releasing, 

memory holding returned valiie, 

III: 4-4:5 
resomxjes. III: 5-6 

Remote disite, 

ATTACHS search list for, II: 
3-6 

Remote File Access (RFA), II: 

1-5 

Remote objects, II: 1-5 



Removal of EPFs, I: 1-16, 3-30 
from memory via EPP$DEL 
subroutine, III: 4-37 
process-class library, I: 3-33 
program EPF, I: 3-33 
program-class library, I: 3-33 

REN ccmmanl (See REENTER 
command) 

Replacing static-mode libraries, 
I: 3-30 

Reserved entrypoint names, I: 
6-5 
list of, I: 6-6 

RESC3LVE_PEFERRED COMMON, 

as a subcommand of BIND, I: 

3-15 
to display common area address, 

I: 3-15 

Resources, 

dynamic. III: 6-2 
per-tiser limits. III: 1-13 
releasing. III: 5-6 
static. III: 6-2 
^37stem-wide limits. III: 1-16 

REST$$ subroutine, II: 4-7 

Restarting suspended programs, 
III: 5-7 
with REENTER command. III: 
5-13 

RESU$$ subroutine, II: 4-7 

RESUME command, II: 2-2 

special treatment ty command 
processor. III: 2-5 

Return codes, II: 2-9 

Returned character strings. III: 
1-12 

Returned command statxis, 

checiting after EPF$RUN, III: 
4-25 

Returned function value pointer 
(See Rtn-fcn-ptr) 
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Retunied fujocrtlon value 

structttre. III: 4-15 
aooessed from FCRIRAN, III: 

4-15, 4-16 
aooessed from PLIG, III: 4-15 
deallooating memory via FRE$RA, 

III: 4-45 
using and freeing It after 

calUng EPPSRON, III: 4-25 

Returned valvie, 
defined. III: 3-6 
f reeling memory used by. III: 
4-45 

Returned value pointer ( See 
Rtn-fcn-ptr) 

Revision 20.0. 
new features, 0: C-8 

Revision 20.2, 
new features, 0: C-7 

Revision 21.0, 

new feattires, 0: C-3 

Revision 22.0, 

new features, 0: C-1 

RLS commaDd ( See RKTFASEJLEVEL 
command) 

.RPn suffix, I: 1-2 

Rtn-fcn-ptr, III: 3-9, 4-13, 
4-14 
declaration of structure. III: 

4-15 
for EPF$RUN subroutine. III: 
4-24 

.RON suffix, I: 1-2 

Running a remote EPF, I: 3-36 

RVLOCK, 

configuration directive, II: 
10-2 



S mode, I: 1-5 

SAC command, II: 2-17 

SAM, II: 1-15 
segment directory, II: 1-25 

Saniple prograons, 

command functions, III: 3-11, 

3-14 
TiaiTtillng command processing 

information. III: 4-51 
handling QDIT$ condition, III: 

5-16 
siiowlng EPF Invocation and 

execution. III: 4-47 
using command processing 

Information, III: 3-22 

SATR$$ subroutine, II: 2-9, 4-7, 
8-6, 8-8, 8-10, 10-3 

SAVES $ subroutine, II: 4-7 

SB (See Stactc base) 

Screen handlers, building. III: 
6-3 

Search list, II: 3-1 

( See also Entrypoint search 

list) ~ 
appeTvilTig to, II: 3-11 
creating, II: 3-20 
defaults, II: 3-2, 3-4 
deleted automatically, II: 3-6 
deleting, II: 3-20 
duplicate rules, II: 3-11 
initializing, II: 3-20 
listing all, II: 3-20 
naming, II: 3-11 
reading, II: 3-20 
setting, II: 3-2, 3-9 to 3-11, 

3-20 
user-defined, II: 3-3, 3-5 

Search order for filenames. III: 
1-10 
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Seaxcjli rule, I: 1-3, 6-12, 6-33 

to 6-36; II: 3-1 
adding rule to list, II: 3-20 
Gbecking existenoe of, II: 

3-20 
cireating, II: 3-10 
deleting rule from list, II: 

3-20 
disabled/ensLbled , II: 3-15 
duplicate rule, II: 3-11 
ensLbling/disabling rule, II: 

3-20 
format, II: 3-21 
locator pointer, II: 3-5 
nonexistent object, II: 3-11, 

3-21 
optional, II: 3-15 
reading, II: 3-20 
setting locator pointer, II: 

3-20 
supplying at runtione, II: 3-18 
\iser-specified, II: 3-3, 3-5 

Search rule keywords, II: 3-12 
-added_disks, II: 3-6, 3-16 
[lioine_dir] , II: 3-17 
-insert, II: 3-12 
-optional, II: 3-15 
[origiA_dir] , II: 3-17 
-priinos_direct_entries , II : 

3-17 
[referencing_dir] , II: 3-16 
-St at ic_jnode_l ibraries , II : 

3-16 
-system, II: 3-13, 3-15 

Seaxdi rule subroutines, II: 
3-2, 3-11, 3-12. 3-19, 3-20 
OPSR$, II: 3-18 
GPSBS$, II: 3-16 
SRSENABL, II: 3-15 
SRSINIT, II: 3-11 
SRSREAD, II: 3-12 
SR$SSR, II: 3-11, 3-14 

Search rules faxjility, II: 3-1 
error in search list, II: 3-11 
involving, II: 3-2 
performance, II: 3-3 
process-based, II: 3-2 
search scope, II: 3-3 
search seqtienoe, II: 3-2, 3-3, 

3-21 
using, II: 3-2, 3-3 



Search rules file, II: 3-1 
comments, II: 3-10 
creating, II: 3-9 
effect of changes to, II: 3-11 
multiple files, II: 3-12 
naming, II: 3-9 
nesting, II: 3-12 
\ised to set search list, II: 
3-11 

SEARCH_RUIiES* , II: 3-i, 3-11 

sectors, II: 1-5 

SBG, I: 1-2, 1-i 
building shared programs, I: 

1-8 
for invoiking V- or I-mode 

programs , 1:1-7 
for shared procedure segments, 

I: 1-8 
generating static-mode images, 

I: 1-8 

Segment aocess, 
as argument to EPF$MAP 

subroutine. III: 4-29 
to DATA segments, I: 3-16 
to IMPURE segments, I: 3-16 
to FROG segments, I: 3-15 

Segment directory, II: 1-9, 6-2 
closing, II: 6-4 
deleting a file, II: 6-23 
ending position, II: 6-28 
extending, II: 6-14 
extending full length, II: 

6-15 
fiixi free entry, II: 6-25 
find full entry, II: 6-25 
opening, II: 6-3 
opening a file, II: 6-17 
positioning in, II: 6-10 
reading, II: 2-32 
scanning, II: 6-25 
size. II: 6-15 
starting position, II: 6-26 
writing, II: 2-34 

Segment number, 

for IMPURE aixl DATA segment, 

I: 9-3 
for PURE segment, I: 9-3 
in addresses. I: 9-2 
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Segment mmiter (continued) 
sign of, I: 9-2, 9-3 
use of ty BIND, I: 3-10 

-SBQMENTJDIKEJCniCRY bit , III : 
3-21, 4-33 

Segments, 
shared S37stem-wide, I: 1-8, 

8-3 
static, I: 8-3 

Separation of pure and inrpure 
code, I: 1-13, 1-15 

Sequential Access Method (SAM), 
II: 1-15 

Set search list, II: 3-2, 3-9 to 

3-11 
nonexistent object, II: 3-11 
relocating ss^stem rules, II: 

3-14 
suppressing S37stem rules, II: 

3-14 
using multiple files, II: 3-12 

SETjyXESS command, II: 2-17 

SET_SEARCHJRULES command, II: 
3-11 
error, II: 3-13 
-no_system option, II: 3-14 
reset option, II: 3-11 

Severity code, 

as argument to CP$, III: 4-12 
as argument to EPFSRON, III: 

4-22 
for command calling sequence, 

III: 3-6 
retiomed ty EPF, III: 1-12 

SC3D$DL subroutine, II: 2-34, 
2-38, 5-48, 6-2, 6-3, 6-24, 
6-25 

SGD$EX subroutine, II: 5-47, 
5-48, 6-2, 6-3 

SGD$OP subroutine, II: 5-2, 5-7, 
5-9, 5-48, 6-2, 6-3, 6-17, 
6-19, 6-22 



SGCR$$ subroutine, II: 2-31, 

2-34, 6-2, 6-3, 6-12 to 6-14, 
6-16, 6-17, 6-25 to 6-29, 
6-43 

Shared applications, ( See also 
Shared programs) 
effect of EPFs on existing, I: 
4-8 

Shared data, I: 8-1 to 8-7 
determining the address of, I: 

8-2 
how to update atomically, I: 

8-7, 8-8 
initializing, I: 8-3, 8-^ 
PMA subroutines for updating, 

I: 8-9 to 8-11 
process-wide, I: 8-1 
S37stem-wide, I: 8-1 
vising a process-class Libreoy 

EPF for, I: 8-5 

Shared programs, 
deleting old. versions, I: 1-16 
installing new versions, I: 

1-8, 1-16 
vising SBG to build, I: 1-8 

Shared system-wide segments, I: 
1-8 

Sharing faulted IPs, I: 4-9 
how to avoid, I: 4-10 

Sharing of pure code, I: 1-13 

SHDTDN commarxi, II: 1-26, 4-5 

Simple pathname, II: 1-13 

Simple program, 
defined, III: 1-8 

Simultaneous use of an EPF, I: 
3-35 

SLIST coramaaa, II: 4-9 

Snapping dynamic links, I: 2-3, 
3-21 

Source code file, searching 
directories for, II: 3-18 
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SPAS$$ subroutine, II: 4-7 

^)ecial/not-special attribute, 
II: 1-38 

SEOI$$ subroutine, II: 1-17, 
2-26, 2-27, 2-36, 2-38, 4-7, 
4-8, 4-21, 4-23, 5-2, 5-7, 
5-10, 5-15, 5-47, 5-46, 6-3, 
6-4, 6-7, 6-30, 6-34, 6-36, 
6-38 
used to open file for VMFA 
reeid. III: 4-19 

SBSFX.$ sutJTOutine, II: 1-17, 
2-26, 2-27, 2-36, 2-38, 4-6, 
4-24, 5-2, 5-7, 5-8, 5-47, 
5^8, 6-3, 6-4, 6-6, 6-30, 
6-34, 6-37, 6-43 
\:ised to open file for VMFA 
read. III: 4-19 

SSR ( See SET_SEARCH_RULES) 

Stack base, I: 3-4 

Stack frame, I: 3-4; 
addresses of in DOMP_STACK 

commaTvl, I: 9-9 
locating procedure, I: 9-10 

Stack frames, 
releasing, III: 5-6 

Stack header, I: 3^ 

Stack space, 

In EPFs, I: 3-3 

in subroutines, I: 3-4 

Stack, command processor. III: 
5-1 

Stacking program EPFs, I: 1-17 

Staaiard command processor. III: 
1-20 
( See also Cammand prooe^or) 

START cammand. III: 5-14 

Static data, I: 3-7 



Static information and EPFs, 
command line information, I: 

4-7 
error infonnation, I: 4-7 

Static memory, I: 1-9 

Static resources. III: 6-2 
cache attach point, III: 6-2 
escape sequences sent to 

terminal, III: 6-4 
file names, III: 6-3 
•user's display screen. III: 

6-3 

Static storage, 
and recusive invocation, III: 
4-54 

Static-mode, ( See also 

Static-mode applications) 

limits on flexibility of 
programs, III: 4-4 

program, I: 1-5 

runfile, searching for, II: 
3-7 

Static-mode applications, ( See 
also Static-mode program! 
conversion strategy, I: 4-1 
relation of EPFs to, I: 4-1 
restriction on EPF nse of, I: 

4-2 
suspending and continuing, I: 
4-2 

Static-mode library, I: 3-28; 
II: 3-16 
dynamic link to, I: 3-28 
replacing, I: 3-30 
restriction on EPF use of, I: 
4-4 

Static-mode program, 
characteristics of, I: 1-6, 

1-7 
invdker. III: 2-7 

STDCP$ subroutine. III: 1-20 

Storage, II: 1-2 
static. III: 4-54 

STCSIAGE coixiition, III: 1-15 
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Sub-UFD (See Lower-level 
Direcrtory) 

SuMirectory (See Lower-level 
Direcbory) 



Subroutin 


e. ( 


.See also library 


EPF) 




AC$CAT, 


II 


2-19, 7-2. 7-5 


ACSCHU, 


II 


7-2, 7-6, 7-7, 7-9 


AC$EFT, 


II 


2-17, 7-2, 7-3 


ACSLIZ, 


II 


2-20, 7-8 


AC$I5T. 


II 


7-2, 7-9, 7-10 


AC$RVT. 


II 


4-7 


AC$SET, 


II 


2-18, 2-21, 7-2, 


7-i, 


7-6 




ATS, II: 2- 


-15, 4-5, 4-7, 4-8, 


4-10 






ATSABS. 


II 


2-15, 4-5, 4-7 to 


4-9, 


4-11 




AT$ANY, 


II 


2-15, 4-5, 4-7, 


4-8, 


4-13 


4^14 


AT$101, 


II 


: 2-8, 2-14, 4-4, 


4-6, 


4-8 




AT$CR, 


II: 


2-13, 4-1, 4-2, 4-6 


AT$REL, 


II 


: 2-15, 4-6, 4-7, 


4-16, 


4-r 


r 


A'iUi$$ , 


II 


: 4-6 


GALAC$, 


II 


: 7-9 


calls. 


II: 


2-2 


CHSMCD, 


II 


: 5-47 


CLO$FN, 


II 


: 2-36, 5-21, 5-23, 


5-48 






OiDSFa, 


II 


: 2-36, 5-21, 5-22, 


5-48, 


6-2 


, 6-4 


or 08$ A, 


II 


: 2-37 


GNAM$$, 


II 


: 4-7, 6-43 


aJMI$$, 


II 


: 4-7 


ajMO$$, 


II 


: 4-7 



converting nonreentrant to 

reentrant, I: 6-21 to 6-25 
GREA$$. II: 2-24, 4-7 
C2REPW$, II: 2-25, 4-7 
determining class requiz'enients 

of, I: 6-15, 6-16 
determining the use of static 

data by, I: 6-17, 6-18 
DIR$CR, II: 2-24, 6-30, 6-32, 

6-34 
DIR$LS, II: 2-31 
nmSRD, II: 1-29, 2-31, 6-30, 

6-39 to 6-il, 8-1, 8-3 
DIRSSE, II: 2-31 
dynamic linking of, I: 2-1 



Subroutine (continued) 

ENT$RD, II: 2-31, 6-30, 8-1 to 

8-3 
FILSDL, II: 2-38, 4-7, 5^8 
GPAS$$, II: 4-7 
GPATH$, II: 4-7, 4-18, 4-20, 

4-24, 6-43 
invoking EPFs, I: 3-5 
linkage text, I: 3-4 
nonreentrant process-class, I: 

6-20 
optamizing conversion approach 

to, I: 6-25 to 6-28 
organization of, I: 3-4 
PHANTS, II: 4-7 
FHNTMS, II: 4-7 
procedure code, I: 3-4 
process-class, I: 6-15 
program-class, I: 6-15 
PRWF$$, II: 2-35, 5-2, 5-16 to 

5-18, 5-20, 5-29, 5-31 to 

5-42 
Q$READ, II: 9-1, 9-3 
Q$SET, II: 9-5 
RDLDTS, II: 5-2, 5-24 to 5-26, 

5-31 
RESTS $, II: 4-7 
RESU$$, II: 4-7 
SATR$$, II: 2-9, 4-7. 8-6, 

8-8, 8-10, 10-3 
SAVE$$, II: 4-7 
SGDSDL, II: 2-34, 2-38, 5^6, 

6-2, 6-3, 6-24, 6-25 
SGD$EX, II: 5-47, 5-48, 6-2, 

6-3 
SGDSOF, II: 5-2, 5-7, 5-9, 

5-48, 6-2, 6-3, 6-17, 6-19, 

6-22 
SCER$$, II: 2-31, 2-34, 6-2, 

6-3, 6-12 to 6-14, 6-16, 

6-17. 6-25 to 6-29, 6-43 
SPAS$$, II: 4-7 
SRCH$$, II: 1-17, 2-26, 2-27, 

2-36, 2-38, 4-7, 4-8, 4-21, 

4-23, 5-2, 5-7, 5-10, 5-15, 

5-47, 5-48, 6-3, 6-4, 6-7, 

6-30, 6-34, 6-36, 6-38 
SRSFX$, II: 1-17, 2-26. 2-27, 

2-36, 2-38, 4-6, 4-24, 5-2, 

5-7, 5-8, 5-47, 5-48, 6-3, 

6-1, 6-6, 6-30, 6-34, 6-37, 

6-43 
stack space, I: 3-4 
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Subroutine (continued) 

storing data in linkage area 

of, I: 6-18 
TSRC$$, II: 2-26 
>?TLIN$, II: 2-35. 5-2. 5-24, 

5-27, 5-29 

Subroutine libraries, I: 2-1 
types of, I: 2-2 

Subroutine not found condition, 
I: 2-4 

Suffixes, II: 3-7 
search, order of. Ill: l-lO, 
4-3 

Surfaces. II: 1-5 

Suspended programs, 
restarting. III: 5-7 

SYMBOL, 
as a subcommand of BIHD, I: 

3-11, 8-2, 8-4 
to locate common areas, I: 

3-11 

System Administrator, 
default seardti rules, II: 3-4 

^37Stem file, II: l-lO 

System primitives. II: 2-3 

SsTStem prompts. III: 5-5 

System seaxcli rules, II: 3-4 
in search rules file, II: 3-10 
location in list, II: 3-13 
process initialization, II: 

3-11 
reset to, II: 3-11 

SYSTEbLSTORAGES condition. Ill: 
1-15 



Terminal I/O. 



Terminal I/O (continued) 

redirection during recursive 
invocation of EPFs, III: 
4-55 

Terminating an EPF, I: 3-6, 
3-30. 3-31 

TeKt, 

retrieval, II: 5-1 
storage, II: 5-1 
strings, II: 5-1 

Text file, II: 5-1 

( See also Fixed-lengtlx record 

file; Variable-lOTgth record 

file) 
accessing, II: 5-2 
compression, II: 5-24 
current position, II: 5-25 
input line. II: 5-25 
maximum line length., II: 5-25 
open file -unit, II: 5-29 
opening, II: 5-6 
output line, II: 5-25 
positioning to end, II: 5-15 
read variable-length. II: 5-24 
reading, II: 5-6 
write variable-length, II: 

5-24 
writing, II: 5-6 
writing lines to, II: 5-29 

Tilde, use of. III: 2-2 

Top-level directory, II: 1-8 

Tracks. II: 1-5 

Tree structure, 
creating, II: 1-5 

Treewalk bit. III: 3-22, 4-31 

Treewalklng, 
handled by command processor, 

III: 2-6 
in cananand processing 

information. III: 3-22 
in epf-info structure. III: 

4-31 
options for. Ill: 2-6 
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TreevTalking (contimied) 
specified in command. 

information structure. III: 

4-23 
specified in epf-inf o 

structure, III: 4-31 

Truncating a file, II: 1-29, 
5-17 

TSRC$$ subroutine, II: 2-26 
vised to open file for VMFA 
read. III: 4-19 

Types of EPFs, I: 1-3 



Umnapping an EPF, I: 3-34 

User file, II: 1-10 

User programs, 

recursive invocation of. III: 
6-1 

User-defined search list, II: 
3-2 

User-written functions, 

command environment support 
for. III: 1-7 

User-written programs, 

command environment support 
for. III: 1-6 

Users, 

search lists of, II: 3-2 



V-mode programs, I: 1-5 

VariaixLe references, evaltiation 
of. III: 2-1 



VarialiLe-length record file, 
compression character , II: 

5-44 
format, II: 5-42 
pad character, II: 5-43 
space compression, II: 5-43 

Variable-length records, II: 5-3 
advantages, II: 5-3 
termination dharacter, II: 5-3 

-VEEIIFY bit. III: 3-21 

-VKRii-Y option, 
handled ijy command processor. 
Ill: 2-7 

VirtTial memory file access read 
(VMFA-read), II: 1-24 

VPSD command, I: 1-18, 9-8 



V 

-WAI£_FROM bit. III: 3-22 

-WAI«_TO bit. III: 3-22 

Wildcard bit. III: 3-22, 4-31 

Wildcards, 
handled by commaaxi processor, 

III: 2-6 
in command processing 

information. III: 3-21 
in epf-info structure. III: 

4-31 
options for, III: 2-6 

Writing file ss^stem objects, II: 
2-34 

Writing files, II: 2-35 

Writing segment directories, II: 
2-34 

WTLIN$ subroutine, II: 2-35, 
5-2, 5-24, 5-27, 5-29 
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